{"_id":"unist-util-find","_rev":"265332","name":"unist-util-find","description":"Unist node finder utility. Useful for working with remark, rehype and retext.","dist-tags":{"latest":"1.0.2"},"maintainers":[{"name":"blahah","email":"rik@fathomlabs.io"}],"time":{"modified":"2023-03-27T18:58:47.000Z","created":"2016-06-30T14:52:04.132Z","1.0.2":"2020-11-10T18:01:07.007Z","1.0.1":"2016-06-30T14:52:04.132Z"},"users":{},"author":{"name":"Richard Smith-Unna","email":"rik@fathomlabs.io"},"repository":{"type":"git","url":"git+https://github.com/blahah/unist-util-find.git"},"versions":{"1.0.2":{"name":"unist-util-find","version":"1.0.2","description":"Unist node finder utility. Useful for working with remark, rehype and retext.","repository":{"type":"git","url":"git+https://github.com/blahah/unist-util-find.git"},"main":"index.js","scripts":{"test":"standard && node test.js"},"keywords":["unist","remark","retext","rehype","hast","mdast","nlcst","find","search"],"author":{"name":"Richard Smith-Unna","email":"rik@fathomlabs.io"},"license":"MIT","devDependencies":{"remark":"^7.0.0","standard":"^8.0.0","tape":"^4.6.0"},"dependencies":{"lodash.iteratee":"^4.5.0","unist-util-visit":"^1.1.0"},"gitHead":"1200bf5c26af3dc2cf95b7534ed500220ce30959","bugs":{"url":"https://github.com/blahah/unist-util-find/issues"},"homepage":"https://github.com/blahah/unist-util-find#readme","_id":"unist-util-find@1.0.2","_nodeVersion":"12.18.4","_npmVersion":"6.14.6","dist":{"shasum":"4d5b01a69fca2a382ad4f55f9865e402129ecf56","size":2571,"noattachment":false,"key":"/unist-util-find/-/unist-util-find-1.0.2.tgz","tarball":"http://name.csiicloud.com:7001/unist-util-find/download/unist-util-find-1.0.2.tgz"},"_npmUser":{"name":"blahah","email":"rik@fathomlabs.io"},"directories":{},"maintainers":[{"name":"blahah","email":"rik@fathomlabs.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/unist-util-find_1.0.2_1605031266880_0.6674265148628971"},"_hasShrinkwrap":false,"publish_time":1605031267007,"_cnpm_publish_time":1605031267007,"_cnpmcore_publish_time":"2021-12-16T16:25:35.047Z"},"1.0.1":{"name":"unist-util-find","version":"1.0.1","description":"Unist node finder utility. Useful for working with remark, rehype and retext.","repository":{"type":"git","url":"git+https://github.com/blahah/unist-util-find.git"},"main":"index.js","scripts":{"test":"standard && node test.js"},"keywords":["unist","remark","retext","rehype","hast","mdast","nlcst","find","search"],"author":{"name":"Richard Smith-Unna","email":"rik@fathomlabs.io"},"license":"MIT","devDependencies":{"standard":"^7.1.2","tape":"^4.6.0"},"dependencies":{"lodash.iteratee":"^4.5.0","remark":"^5.0.1","unist-util-visit":"^1.1.0"},"gitHead":"42bfcad402ba9ecaf1ac0f37db79b884800aea57","bugs":{"url":"https://github.com/blahah/unist-util-find/issues"},"homepage":"https://github.com/blahah/unist-util-find#readme","_id":"unist-util-find@1.0.1","_shasum":"1062bbb6928c7a97c6adc89b53745d4c46c222a2","_from":".","_npmVersion":"3.8.9","_nodeVersion":"6.2.0","_npmUser":{"name":"blahah","email":"rds45@cam.ac.uk"},"maintainers":[{"name":"blahah","email":"rik@fathomlabs.io"}],"dist":{"shasum":"1062bbb6928c7a97c6adc89b53745d4c46c222a2","size":3362,"noattachment":false,"key":"/unist-util-find/-/unist-util-find-1.0.1.tgz","tarball":"http://name.csiicloud.com:7001/unist-util-find/download/unist-util-find-1.0.1.tgz"},"_npmOperationalInternal":{"host":"packages-16-east.internal.npmjs.com","tmp":"tmp/unist-util-find-1.0.1.tgz_1467298322288_0.8231010283343494"},"directories":{},"publish_time":1467298324132,"_hasShrinkwrap":false,"_cnpm_publish_time":1467298324132,"_cnpmcore_publish_time":"2021-12-16T16:25:35.243Z"}},"readme":"# unist-util-find [![Travis](https://img.shields.io/travis/blahah/unist-util-find.svg)](https://travis-ci.org/blahah/unist-util-find)\n\n[Unist](https://github.com/wooorm/unist) node finder utility. Useful for working with [remark](https://github.com/wooorm/remark), [rehype](https://github.com/wooorm/rehype) and [retext](https://github.com/wooorm/retext).\n\n## Installation\n\n```\nnpm install --save unist-util-find\n```\n\n## Usage\n\n### Example\n\n```js\nvar remark = require('remark')\nvar find = require('unist-util-find')\n\nremark()\n  .use(function () {\n    return function (tree) {\n      // string condition\n      console.log(find(tree, 'value'))\n\n      // object condition\n      console.log(find(tree, { value: 'emphasis' }))\n\n      // function condition\n      console.log(find(tree, function (node) {\n        return node.type === 'inlineCode'\n      }))\n    }\n  })\n  .processSync('Some _emphasis_, **strongness**, and `code`.')\n\n```\n\nResult:\n\n```\n// string condition: 'value'\n{ type: 'text',\n  value: 'Some ',\n  position:\n   Position {\n     start: { line: 1, column: 1, offset: 0 },\n     end: { line: 1, column: 6, offset: 5 },\n     indent: [] } }\n\n// object condition: { value: 'emphasis' }\n{ type: 'text',\n  value: 'emphasis',\n  position:\n   Position {\n     start: { line: 1, column: 7, offset: 6 },\n     end: { line: 1, column: 15, offset: 14 },\n     indent: [] } }\n\n// function condition: function (node) { return node.type === 'inlineCode' }\n{ type: 'inlineCode',\n  value: 'code',\n  position:\n   Position {\n     start: { line: 1, column: 38, offset: 37 },\n     end: { line: 1, column: 44, offset: 43 },\n     indent: [] } }\n```\n\n### API\n\n#### `find(node, condition)`\n\nReturn the first node that matches `condition`, or `undefined` if no node matches.\n\n- `node` ([`Node`](https://github.com/wooorm/unist#node)) - Node to search\n- `condition` (`string`, `object` or `function`) - Condition used to test each node. Behaviour depends on the type of the condition:\n  - `string` finds first node with a truthy property matching `string`\n  - `object` finds first node that has matching values for all properties of `object`\n  - `function` finds first node for which `function` returns true when passed `node` as argument\n\n## License\n\nMIT\n","_attachments":{},"homepage":"https://github.com/blahah/unist-util-find#readme","bugs":{"url":"https://github.com/blahah/unist-util-find/issues"},"license":"MIT"}