Home

Awesome

exists-file

Last version Build Status Coverage Status Dependency status Dev Dependencies Status NPM Status Donate

Check if a file exists. A fs.exists implementation that is not deprecated.

Because fs.exist and fs.existsSync are deprecated this an implementation using fs.stats and fs.statsSync for get the same result.

Also always keep in mind:

fs.exists() should not be used to check if a file exists before calling fs.open(). Doing so introduces a race condition since other processes may change the file's state between the two calls. Instead, user code should call fs.open() directly and handle the error raised if the file is non-existent.

Install

npm install exists-file --save

Usage

var existsFile = require('exists-file')

// async with a callback
existsFile('./README.md', console.log) // => null, true

// async with a promise
existsFile('./README.md').then(console.log).catch(console.error) // => true

// sync
var exists = existsFile.sync('./README.md')
console.log(exists) // => true

API

existsFile(filepath, [cb])

filepath

Required <br> Type: string

The relative or absolute file path.

cb

Type: function

If cb is not provided then it returns a promise.

existsFile.sync(filepath)

filepath

Required <br> Type: string

The relative or absolute file path.

License

MIT © Kiko Beats