JSPM

find-up-simple

1.0.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3496172
  • Score
    100M100P100Q201823F
  • License MIT

Find a file or directory by walking up parent directories — Zero dependencies

Package Exports

  • find-up-simple

Readme

find-up-simple

Find a file or directory by walking up parent directories

This is a simpler version of my find-up package, now with zero dependencies.

Install

npm install find-up-simple

Usage

/
└── Users
    └── sindresorhus
        ├── unicorn.png
        └── foo
            └── bar
                ├── baz
                └── example.js

example.js

import {findUp} from 'find-up-simple';

console.log(await findUp('unicorn.png'));
//=> '/Users/sindresorhus/unicorn.png'

API

findUp(name, options?)

Returns a Promise for the found path or undefined if it could not be found.

findUpSync(name, options?)

Returns the found path or undefined if it could not be found.

name

Type: string

The name of the file or directory to find.

options

Type: object

cwd

Type: URL | string
Default: process.cwd()

The directory to start from.

type

Type: string
Default: 'file'
Values: 'file' | 'directory'

The type of path to match.

stopAt

Type: URL | string
Default: Root directory

The last directory to search before stopping.

FAQ

How is it different from find-up?

  • No support for multiple input names
  • No support for finding multiple paths
  • No custom matching
  • No symlink option
  • Zero dependencies
  • find-up - A more advanced version of this package
  • find-up-cli - CLI for this module
  • package-up - Find the closest package.json file
  • pkg-dir - Find the root directory of an npm package