You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
74 lines
2.2 KiB
74 lines
2.2 KiB
4 years ago
|
# is-resolvable
|
||
|
|
||
|
[![npm version](https://img.shields.io/npm/v/is-resolvable.svg)](https://www.npmjs.com/package/is-resolvable)
|
||
|
[![Build Status](https://travis-ci.org/shinnn/is-resolvable.svg?branch=master)](https://travis-ci.org/shinnn/is-resolvable)
|
||
|
[![Build status](https://ci.appveyor.com/api/projects/status/ww1cdpignehlasbs?svg=true)](https://ci.appveyor.com/project/ShinnosukeWatanabe/is-resolvable)
|
||
|
[![Coverage Status](https://img.shields.io/coveralls/shinnn/is-resolvable.svg)](https://coveralls.io/r/shinnn/is-resolvable)
|
||
|
|
||
|
A [Node.js](https://nodejs.org/) module to check if a given module ID is resolvable with [`require()`](https://nodejs.org/api/globals.html#globals_require)
|
||
|
|
||
|
```javascript
|
||
|
const isResolvable = require('is-resolvable');
|
||
|
|
||
|
isResolvable('fs'); //=> true
|
||
|
isResolvable('path'); //=> true
|
||
|
|
||
|
// When ./index.js exists
|
||
|
isResolvable('./index.js') //=> true
|
||
|
isResolvable('./index') //=> true
|
||
|
isResolvable('.') //=> true
|
||
|
```
|
||
|
|
||
|
## Installation
|
||
|
|
||
|
[Use](https://docs.npmjs.com/cli/install) [npm](https://docs.npmjs.com/getting-started/what-is-npm).
|
||
|
|
||
|
```
|
||
|
npm install is-resolvable
|
||
|
```
|
||
|
|
||
|
## API
|
||
|
|
||
|
```javascript
|
||
|
const isResolvable = require('is-resolvable');
|
||
|
```
|
||
|
|
||
|
### isResolvable(*moduleId* [, *options*])
|
||
|
|
||
|
*moduleId*: `string` (module ID)
|
||
|
*options*: `Object` ([`require.resolve`](https://nodejs.org/api/modules.html#modules_require_resolve_request_options) options)
|
||
|
Return: `boolean`
|
||
|
|
||
|
It returns `true` if `require()` can load a file form a given module ID, otherwise `false`.
|
||
|
|
||
|
```javascript
|
||
|
const isResolvable = require('is-resolvable');
|
||
|
|
||
|
// When ./foo.json exists
|
||
|
isResolvable('./foo.json'); //=> true
|
||
|
isResolvable('./foo'); //=> true
|
||
|
|
||
|
isResolvable('./foo.js'); //=> false
|
||
|
|
||
|
// When `eslint` module is installed but `jshint` isn't
|
||
|
isResolvable('eslint'); //=> true
|
||
|
isResolvable('jshint'); //=> false
|
||
|
|
||
|
// When `lodash` module is installed
|
||
|
isResolvable('lodash/isObject'); //=> true
|
||
|
isResolvable('lodash/fp/reject.js'); //=> true
|
||
|
```
|
||
|
|
||
|
The second argument accepts an options object for `require.resolve()`.
|
||
|
|
||
|
```javascript
|
||
|
// When ./bar/baz.js exists
|
||
|
|
||
|
isResolvable('./baz.js'); //=> false
|
||
|
isResolvable('./baz.js', {paths: ['bar']}); //=> true
|
||
|
```
|
||
|
|
||
|
## License
|
||
|
|
||
|
[ISC License](./LICENSE) © 2018 Shinnosuke Watanabe
|