History

Cody Loyd 834d78b8b2 remove timer and simon		2017-12-15 12:56:14 -06:00
..
index.js	remove timer and simon	2017-12-15 12:56:14 -06:00
license	remove timer and simon	2017-12-15 12:56:14 -06:00
package.json	remove timer and simon	2017-12-15 12:56:14 -06:00
readme.md	remove timer and simon	2017-12-15 12:56:14 -06:00

readme.md

find-up

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'
});

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

API

findUp(filename, [options])

Returns a Promise for the filepath or null.

findUp([filenameA, filenameB], [options])

Returns a Promise for the first filepath found (by respecting the order) or null.

findUp.sync(filename, [options])

Returns a filepath or null.

findUp.sync([filenameA, filenameB], [options])

Returns the first filepath found (by respecting the order) or null.

filename

Type: string

Filename of the file to find.

options

cwd

Type: string
Default: process.cwd()

Directory to start from.

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