Package Exports
- is-there
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (is-there) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
is-there
Check if a file or directory exists in a given path.
Why? fs.exists
already does the job!
Because fs.exists
and fs.existsSync
will be deprecated and I still like and need them!
fs.exists()
is an anachronism and exists only for historical reasons. There should almost never be a reason to use it in your own code.
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()
andfs.open()
. Just open the file and handle the error when it's not there.
fs.exists()
will be deprecated.
(Source, emphasis added)
Installation
$ npm install is-there
Example
// Dependencies
var IsThere = require("is-there");
// Async call
IsThere("path/to/the/file/or/directory", function (exists) {
if (exists) {
// do something if it exists
} else {
// do something if it doesn't exist
}
});
// Sync call (without providing the callback function)
var exists = IsThere("path/to/the/file/or/directory");
if (exists) {
// do something if it exists
} else {
// do something if it doesn't exist
}
Documentation
IsThere(path, callback)
Checks if a file or directory exists on given path.
Params
- String
path
: The path to the file or directory. - Function
callback
: The callback function called with a boolean value representing if the file or directory exists. If this parameter is not a function, the function will run the synchronously and return the value.
Return
- IsThere|Boolean The
IsThere
function if thecallback
parameter was provided, otherwise a boolean value indicating if the file/directory exists or not.
How to contribute
- File an issue in the repository, using the bug tracker, describing the contribution you'd like to make. This will help us to get you started on the right foot.
- Fork the project in your account and create a new branch:
your-great-feature
. - Commit your changes in that branch.
- Open a pull request, and reference the initial issue in the pull request message.
License
See the LICENSE file.