tree: e171a35c4a4a10a344f1d50122fc450fa40c5272 [path history] [tgz]
  1. index.js
  2. license
  3. package.json
  4. readme.md
third_party/devtools/node_modules/find-up/readme.md

find-up Build Status

Find a file by walking up parent directories

Install

$ npm install --save find-up

Usage

/
└── Users
    └── sindresorhus
        ├── unicorn.png
        └── foo
            └── bar
                ├── baz
                └── example.js
// example.js
const findUp = require('find-up');

findUp('unicorn.png').then(filepath => {
	console.log(filepath);
	//=> '/Users/sindresorhus/unicorn.png'
});

API

findUp(filename, [options])

Returns a promise for the filepath or null.

findUp.sync(filename, [options])

Returns a filepath or null.

filename

Type: string

Filename of the file to find.

options

cwd

Type: string
Default: process.cwd()

Directory to start from.

Related

  • find-up-cli - CLI for this module
  • pkg-up - Find the closest package.json file
  • pkg-dir - Find the root directory of an npm package

License

MIT © Sindre Sorhus