Sha256: dd245531ccb5675992d10c664754e0a9bc31ef152058b2fea0697acb30fc0f47

Contents?: true

Size: 1.19 KB

Versions: 38

Compression:

Stored size: 1.19 KB

Contents

# path-exists [![Build Status](https://travis-ci.org/sindresorhus/path-exists.svg?branch=master)](https://travis-ci.org/sindresorhus/path-exists)

> Check if a path exists

Because [`fs.exists()`](https://nodejs.org/api/fs.html#fs_fs_exists_path_callback) is being [deprecated](https://github.com/iojs/io.js/issues/103), but there's still a genuine use-case of being able to check if a path exists for other purposes than doing IO with it.

Never use this before handling a file though:

> In particular, checking if a file exists before opening it is an anti-pattern that leaves you vulnerable to race conditions: another process may remove the file between the calls to `fs.exists()` and `fs.open()`. Just open the file and handle the error when it's not there.


## Install

```
$ npm install --save path-exists
```


## Usage

```js
// foo.js
var pathExists = require('path-exists');

pathExists('foo.js').then(function (exists) {
	console.log(exists);
	//=> true
});
```


## API

### pathExists(path)

Returns a promise that resolves to a boolean of whether the path exists.

### pathExists.sync(path)

Returns a boolean of whether the path exists.


## License

MIT © [Sindre Sorhus](http://sindresorhus.com)

Version data entries

38 entries across 34 versions & 15 rubygems

Version Path
optimacms-0.1.61 spec/dummy/node_modules/read-pkg-up/node_modules/path-exists/readme.md
disco_app-0.18.0 test/dummy/node_modules/read-pkg-up/node_modules/path-exists/readme.md
disco_app-0.18.2 test/dummy/node_modules/read-pkg-up/node_modules/path-exists/readme.md
tang-0.2.1 spec/tang_app/node_modules/read-pkg-up/node_modules/path-exists/readme.md
groonga-client-model-6.0.0 test/apps/rails6.1.3/node_modules/read-pkg-up/node_modules/path-exists/readme.md
groonga-client-model-6.0.0 test/apps/rails6.0.3.5/node_modules/read-pkg-up/node_modules/path-exists/readme.md
ruby2js-4.0.4 lib/tasks/testrails/node_modules/read-pkg-up/node_modules/path-exists/readme.md
ruby2js-4.0.3 lib/tasks/testrails/node_modules/read-pkg-up/node_modules/path-exists/readme.md
tang-0.2.0 spec/tang_app/node_modules/read-pkg-up/node_modules/path-exists/readme.md
tang-0.1.0 spec/tang_app/node_modules/read-pkg-up/node_modules/path-exists/readme.md
tang-0.0.9 spec/tang_app/node_modules/read-pkg-up/node_modules/path-exists/readme.md
enju_library-0.3.8 spec/dummy/node_modules/read-pkg-up/node_modules/path-exists/readme.md
ilog-0.4.1 node_modules/read-pkg-up/node_modules/path-exists/readme.md
ilog-0.4.1 node_modules/laravel-mix/node_modules/path-exists/readme.md
ilog-0.4.0 node_modules/read-pkg-up/node_modules/path-exists/readme.md
ilog-0.4.0 node_modules/laravel-mix/node_modules/path-exists/readme.md
ilog-0.3.3 node_modules/read-pkg-up/node_modules/path-exists/readme.md
ilog-0.3.3 node_modules/laravel-mix/node_modules/path-exists/readme.md
jester-data-8.0.0 node_modules/read-pkg-up/node_modules/path-exists/readme.md
ezii-os-5.2.1 node_modules/read-pkg-up/node_modules/path-exists/readme.md