{"_id":"vfile-find-up","_rev":"157851","name":"vfile-find-up","description":"vfile utility to find one or more files by searching the file system upwards","dist-tags":{"latest":"6.0.0"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"time":{"modified":"2021-06-03T11:37:53.000Z","created":"2015-11-09T09:07:29.863Z","6.0.0":"2021-05-05T15:39:04.099Z","5.0.1":"2020-03-02T15:47:25.857Z","5.0.0":"2019-05-30T17:36:51.914Z","4.0.1":"2019-05-30T11:26:53.701Z","4.0.0":"2018-10-28T11:26:56.019Z","3.0.0":"2018-05-05T09:23:54.944Z","2.0.2":"2018-05-03T20:46:28.330Z","2.0.0":"2016-08-21T14:46:02.476Z","1.0.0":"2015-11-09T09:07:29.863Z"},"users":{},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"},"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"versions":{"6.0.0":{"name":"vfile-find-up","version":"6.0.0","description":"vfile utility to find one or more files by searching the file system upwards","license":"MIT","keywords":["vfile","vfile-util","util","utility","virtual","file","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"funding":{"type":"opencollective","url":"https://opencollective.com/unified"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"}],"sideEffects":false,"type":"module","main":"index.js","types":"index.d.ts","dependencies":{"to-vfile":"^7.0.0","vfile":"^5.0.0"},"devDependencies":{"@types/tape":"^4.0.0","c8":"^7.0.0","prettier":"^2.0.0","remark-cli":"^9.0.0","remark-preset-wooorm":"^8.0.0","rimraf":"^3.0.0","tape":"^5.0.0","type-coverage":"^2.0.0","typescript":"^4.0.0","xo":"^0.39.0"},"scripts":{"prepack":"npm run build && npm run format","build":"rimraf \"*.d.ts\" && tsc && type-coverage","format":"remark . -qfo && prettier . -w --loglevel warn && xo --fix","test-api":"node test/index.js","test-coverage":"c8 --check-coverage --branches 100 --functions 100 --lines 100 --statements 100 --reporter lcov node test/index.js","test":"npm run build && npm run format && npm run test-coverage"},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"rules":{"no-var":"off","prefer-arrow-callback":"off"}},"remarkConfig":{"plugins":["preset-wooorm"]},"typeCoverage":{"atLeast":100,"detail":true,"strict":true},"gitHead":"1e9d8cc5dbf9719d6511b48e68313f0434851bc7","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@6.0.0","_nodeVersion":"15.11.0","_npmVersion":"7.11.1","dist":{"shasum":"51a9ae3abd41bd739bc10f91922e3e26aee12508","size":4573,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-6.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-6.0.0.tgz"},"_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"directories":{},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_6.0.0_1620229143920_0.39478074700389576"},"_hasShrinkwrap":false,"publish_time":1620229144099,"_cnpm_publish_time":1620229144099},"5.0.1":{"name":"vfile-find-up","version":"5.0.1","description":"vfile utility to find one or more files by searching the file system upwards","license":"MIT","keywords":["vfile","vfile-util","util","utility","virtual","file","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"funding":{"type":"opencollective","url":"https://opencollective.com/unified"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"}],"dependencies":{"to-vfile":"^6.0.0"},"devDependencies":{"nyc":"^15.0.0","prettier":"^1.0.0","remark-cli":"^7.0.0","remark-preset-wooorm":"^6.0.0","tape":"^4.0.0","xo":"^0.27.0"},"scripts":{"format":"remark . -qfo && prettier --write \"**/*.js\" && xo --fix","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run format && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"esnext":false},"remarkConfig":{"plugins":["preset-wooorm"]},"gitHead":"bcfb524336994b91be40c01ce05ba9599dc11c2a","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@5.0.1","_nodeVersion":"13.9.0","_npmVersion":"6.13.7","dist":{"shasum":"2d3d855e99013b852c604b18a0e559acf6fd385e","size":3741,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-5.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-5.0.1.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_5.0.1_1583164045741_0.5994524622300401"},"_hasShrinkwrap":false,"publish_time":1583164045857,"_cnpm_publish_time":1583164045857},"5.0.0":{"name":"vfile-find-up","version":"5.0.0","description":"Find files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"}],"dependencies":{"to-vfile":"^6.0.0"},"devDependencies":{"nyc":"^14.0.0","prettier":"^1.0.0","remark-cli":"^6.0.0","remark-preset-wooorm":"^5.0.0","tape":"^4.0.0","xo":"^0.24.0"},"scripts":{"format":"remark . -qfo && prettier --write \"**/*.js\" && xo --fix","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run format && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"esnext":false},"remarkConfig":{"plugins":["preset-wooorm"]},"gitHead":"33dc7af770a59618db9155e5fc16d30a1332cfc6","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@5.0.0","_nodeVersion":"12.2.0","_npmVersion":"6.9.0","dist":{"shasum":"278eea44cdca395bdf4bcb5b36b6d8198e6a482d","size":3686,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-5.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-5.0.0.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_5.0.0_1559237811498_0.956781390626436"},"_hasShrinkwrap":false,"publish_time":1559237811914,"_cnpm_publish_time":1559237811914},"4.0.1":{"name":"vfile-find-up","version":"4.0.1","description":"Find files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"}],"dependencies":{"to-vfile":"^5.0.0"},"devDependencies":{"nyc":"^14.0.0","prettier":"^1.0.0","remark-cli":"^6.0.0","remark-preset-wooorm":"^5.0.0","tape":"^4.0.0","xo":"^0.24.0"},"scripts":{"format":"remark . -qfo && prettier --write \"**/*.js\" && xo --fix","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run format && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"esnext":false},"remarkConfig":{"plugins":["preset-wooorm"]},"gitHead":"36c44fb11eca28383f5fe10c51a5a70bc847b396","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@4.0.1","_nodeVersion":"12.2.0","_npmVersion":"6.9.0","dist":{"shasum":"901b34f7f30e35ea7fef7eea349f4ac65b2ecff3","size":3684,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-4.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-4.0.1.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_4.0.1_1559215613605_0.8445036010385731"},"_hasShrinkwrap":false,"publish_time":1559215613701,"_cnpm_publish_time":1559215613701},"4.0.0":{"name":"vfile-find-up","version":"4.0.0","description":"Find files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"https://wooorm.com"}],"dependencies":{"to-vfile":"^5.0.0"},"devDependencies":{"nyc":"^13.0.0","prettier":"^1.12.1","remark-cli":"^6.0.0","remark-preset-wooorm":"^4.0.0","tape":"^4.0.0","xo":"^0.23.0"},"scripts":{"format":"remark . -qfo && prettier --write '**/*.js' && xo --fix","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run format && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"esnext":false,"rules":{"no-var":"off","prefer-arrow-callback":"off","object-shorthand":"off"}},"remarkConfig":{"plugins":["preset-wooorm"]},"gitHead":"2dc59e59e08a40f240f484c9ea9b91fb0e7b3507","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@4.0.0","_npmVersion":"6.4.1","_nodeVersion":"11.0.0","_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"dist":{"shasum":"191a6d7a3c5d9fe7a91f672bc1c2fbf5eabf0775","size":3527,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-4.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-4.0.0.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_4.0.0_1540726015810_0.46352665255933667"},"_hasShrinkwrap":false,"publish_time":1540726016019,"_cnpm_publish_time":1540726016019},"3.0.0":{"name":"vfile-find-up","version":"3.0.0","description":"Find files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"http://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"http://wooorm.com"}],"files":["index.js"],"dependencies":{"to-vfile":"^4.0.0"},"devDependencies":{"nyc":"^11.0.0","prettier":"^1.12.1","remark-cli":"^5.0.0","remark-preset-wooorm":"^4.0.0","tape":"^4.0.0","xo":"^0.21.0"},"scripts":{"format":"remark . -qfo && prettier --write '**/*.js' && xo --fix","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run format && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"esnext":false,"rules":{"no-var":"off","prefer-arrow-callback":"off","object-shorthand":"off"}},"remarkConfig":{"plugins":["preset-wooorm"]},"gitHead":"d6738a38b9b03920e32cc44556e1c2540c4d2330","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@3.0.0","_npmVersion":"6.0.0","_nodeVersion":"10.0.0","_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"dist":{"shasum":"c0cf7c0877926dea9c5e7c050f6fe59ce05d303e","size":3531,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-3.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-3.0.0.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_3.0.0_1525512234842_0.9441202082314395"},"_hasShrinkwrap":false,"publish_time":1525512234944,"_cnpm_publish_time":1525512234944},"2.0.2":{"name":"vfile-find-up","version":"2.0.2","description":"Find files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward"],"repository":{"type":"git","url":"git+https://github.com/vfile/vfile-find-up.git"},"bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"http://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"http://wooorm.com"}],"files":["index.js"],"dependencies":{"to-vfile":"^2.0.0"},"devDependencies":{"nyc":"^11.0.0","prettier":"^1.12.1","remark-cli":"^5.0.0","remark-preset-wooorm":"^4.0.0","tape":"^4.0.0","xo":"^0.20.0"},"scripts":{"format":"remark . -qfo && prettier --write '**/*.js' && xo --fix","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run format && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"prettier":{"tabWidth":2,"useTabs":false,"singleQuote":true,"bracketSpacing":false,"semi":false,"trailingComma":"none"},"xo":{"prettier":true,"esnext":false,"rules":{"no-var":"off","prefer-arrow-callback":"off","object-shorthand":"off"}},"remarkConfig":{"plugins":["preset-wooorm"]},"gitHead":"be742c4ccb7e57edda4fecfb71d496dd97c68e9a","homepage":"https://github.com/vfile/vfile-find-up#readme","_id":"vfile-find-up@2.0.2","_npmVersion":"6.0.0","_nodeVersion":"10.0.0","_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"dist":{"shasum":"bd64ca2a9a26aabb6d537d9c38548c36ecf927c7","size":3530,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-2.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-2.0.2.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vfile-find-up_2.0.2_1525380388242_0.37529372257132265"},"_hasShrinkwrap":false,"publish_time":1525380388330,"_cnpm_publish_time":1525380388330},"2.0.0":{"name":"vfile-find-up","version":"2.0.0","description":"Find files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward"],"dependencies":{"to-vfile":"^2.0.0"},"files":["index.js"],"repository":{"type":"git","url":"git+https://github.com/wooorm/vfile-find-up.git"},"bugs":{"url":"https://github.com/wooorm/vfile-find-up/issues"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"http://wooorm.com"},"contributors":[{"name":"Titus Wormer","email":"tituswormer@gmail.com","url":"http://wooorm.com"}],"devDependencies":{"nyc":"^8.1.0","remark-cli":"^1.0.0","remark-comment-config":"^4.0.0","remark-github":"^5.0.0","remark-lint":"^4.0.0","remark-validate-links":"^4.0.0","tape":"^4.0.0","xo":"^0.16.0"},"scripts":{"build-md":"remark . --quiet --frail","build":"npm run build-md","lint":"xo","test-api":"node test","test-coverage":"nyc --reporter lcov tape test/index.js","test":"npm run build && npm run lint && npm run test-coverage"},"nyc":{"check-coverage":true,"lines":100,"functions":100,"branches":100},"xo":{"space":true},"remarkConfig":{"output":true,"plugins":{"comment-config":null,"github":null,"lint":{"list-item-spacing":false,"heading-increment":false},"validate-links":null},"settings":{"bullet":"*"}},"gitHead":"b894c1c909168fc8308964fcb71050bf55207f6e","homepage":"https://github.com/wooorm/vfile-find-up#readme","_id":"vfile-find-up@2.0.0","_shasum":"d32cacd13b4d327888bb47a1e827a63d68dfaad1","_from":".","_npmVersion":"3.3.6","_nodeVersion":"5.0.0","_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"dist":{"shasum":"d32cacd13b4d327888bb47a1e827a63d68dfaad1","size":3769,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-2.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-2.0.0.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"_npmOperationalInternal":{"host":"packages-16-east.internal.npmjs.com","tmp":"tmp/vfile-find-up-2.0.0.tgz_1471790761008_0.14761478872969747"},"directories":{},"publish_time":1471790762476,"_cnpm_publish_time":1471790762476,"_hasShrinkwrap":false},"1.0.0":{"name":"vfile-find-up","version":"1.0.0","description":"Find one or more files by searching the file system upwards","license":"MIT","keywords":["vfile","walk","find","up","upward","upwards","above","retext","mdast"],"repository":{"type":"git","url":"git+https://github.com/wooorm/vfile-find-up.git"},"dependencies":{"to-vfile":"^1.0.0"},"author":{"name":"Titus Wormer","email":"tituswormer@gmail.com"},"files":["index.js"],"devDependencies":{"eslint":"^1.0.0","esmangle":"^1.0.0","istanbul":"^0.3.0","jscs":"^2.0.0","jscs-jsdoc":"^1.0.0","mdast":"^1.0.0","mdast-comment-config":"^1.0.0","mdast-github":"^1.0.0","mdast-lint":"^1.0.0","mdast-slug":"^2.0.0","mdast-validate-links":"^1.1.1","tape":"^4.2.0"},"scripts":{"build-md":"mdast . --quiet  --frail","build":"npm run build-md","lint-api":"eslint .","lint-style":"jscs --reporter inline .","lint":"npm run lint-api && npm run lint-style","test-api":"node test/index.js","test-coverage":"istanbul cover test/index.js","test":"npm run build && npm run lint && npm run test-coverage"},"gitHead":"a16e2a53ad25c9c00ce43e8343a56f460f620387","bugs":{"url":"https://github.com/wooorm/vfile-find-up/issues"},"homepage":"https://github.com/wooorm/vfile-find-up#readme","_id":"vfile-find-up@1.0.0","_shasum":"5604da6fe453b34350637984eb5fe4909e280390","_from":".","_npmVersion":"3.3.5","_nodeVersion":"4.1.1","_npmUser":{"name":"wooorm","email":"tituswormer@gmail.com"},"dist":{"shasum":"5604da6fe453b34350637984eb5fe4909e280390","size":4280,"noattachment":false,"key":"/vfile-find-up/-/vfile-find-up-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/vfile-find-up/download/vfile-find-up-1.0.0.tgz"},"maintainers":[{"name":"wooorm","email":"tituswormer@gmail.com"}],"directories":{},"publish_time":1447060049863,"_cnpm_publish_time":1447060049863,"_hasShrinkwrap":false}},"readme":"# vfile-find-up\n\n[![Build][build-badge]][build]\n[![Coverage][coverage-badge]][coverage]\n[![Downloads][downloads-badge]][downloads]\n[![Sponsors][sponsors-badge]][collective]\n[![Backers][backers-badge]][collective]\n[![Chat][chat-badge]][chat]\n\nFind [vfile][]s by searching the file system upwards.\n\n## Install\n\nThis package is [ESM only](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c):\nNode 12+ is needed to use it and it must be `import`ed instead of `require`d.\n\n[npm][]:\n\n```sh\nnpm install vfile-find-up\n```\n\n## Use\n\n```js\nimport {findUp} from 'vfile-find-up'\n\nfindUp('package.json', console.log)\n```\n\nYields:\n\n```js\nnull [ VFile {\n  data: {},\n  messages: [],\n  history: [ '/Users/tilde/projects/oss/vfile-find-up/package.json' ],\n  cwd: '/Users/tilde/projects/oss/vfile-find-up' } ]\n```\n\n## API\n\nThis package exports the following identifiers: `findUp`, `findUpOne`, `INCLUDE`,\n`BREAK`.\nThere is no default export.\n\n### `findUp(tests[, path][, callback])`\n\nSearch for `tests` upwards.\nCalls callback with either an error or an array of files passing `tests`.\nNote: Virtual Files are not read (their `contents` is not populated).\n\n##### Sigantures\n\n*   `(tests: Test, path?: string, callback: Callback): void`\n*   `(tests: Test, path?: string): Promise.<Array.<VFile>>`\n\n##### Parameters\n\n###### `tests`\n\nThings to search for (`string`, `Function`, or `Array.<tests>`).\n\nIf a `string` is passed in, the `basename` or `extname` of files must match it\nfor them to be included.\n\nIf an array is passed in, any test must match a given file for it to be\nincluded.\n\nOtherwise, they must be [`function`][test].\n\n###### `path`\n\nPlace to searching from (`string`, default: `process.cwd()`).\n\n###### `callback`\n\nFunction called with all matching files (`function cb(err[, files])`).\n\n### `findUpOne(tests[, path][, callback])`\n\nLike `findUp`, but either calls `callback` with the first found file, or `null`\nor without callback resolves to a file or `null`.\n\n### `function test(file)`\n\nCheck whether a virtual file should be included.\nCalled with a [vfile][].\n\n##### Returns\n\n*   `true` or `INCLUDE` — Include the file in the results\n*   `BREAK` — Stop searching for files\n*   anything else is ignored: the file is not included\n\nThe different flags can be combined by using the pipe operator:\n`INCLUDE | BREAK`.\n\n## Contribute\n\nSee [`contributing.md`][contributing] in [`vfile/.github`][health] for ways to\nget started.\nSee [`support.md`][support] for ways to get help.\n\nThis project has a [code of conduct][coc].\nBy interacting with this repository, organization, or community you agree to\nabide by its terms.\n\n## License\n\n[MIT][license] © [Titus Wormer][author]\n\n<!-- Definitions -->\n\n[build-badge]: https://github.com/vfile/vfile-find-up/workflows/main/badge.svg\n\n[build]: https://github.com/vfile/vfile-find-up/actions\n\n[coverage-badge]: https://img.shields.io/codecov/c/github/vfile/vfile-find-up.svg\n\n[coverage]: https://codecov.io/github/vfile/vfile-find-up\n\n[downloads-badge]: https://img.shields.io/npm/dm/vfile-find-up.svg\n\n[downloads]: https://www.npmjs.com/package/vfile-find-up\n\n[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg\n\n[backers-badge]: https://opencollective.com/unified/backers/badge.svg\n\n[collective]: https://opencollective.com/unified\n\n[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg\n\n[chat]: https://github.com/vfile/vfile/discussions\n\n[npm]: https://docs.npmjs.com/cli/install\n\n[contributing]: https://github.com/vfile/.github/blob/HEAD/contributing.md\n\n[support]: https://github.com/vfile/.github/blob/HEAD/support.md\n\n[health]: https://github.com/vfile/.github\n\n[coc]: https://github.com/vfile/.github/blob/HEAD/code-of-conduct.md\n\n[license]: license\n\n[author]: https://wooorm.com\n\n[vfile]: https://github.com/vfile/vfile\n\n[test]: #function-testfile\n","_attachments":{},"homepage":"https://github.com/vfile/vfile-find-up#readme","bugs":{"url":"https://github.com/vfile/vfile-find-up/issues"},"license":"MIT"}