90 lines
1.6 KiB
Markdown
90 lines
1.6 KiB
Markdown
|
# has-flag [![Build Status](https://travis-ci.org/sindresorhus/has-flag.svg?branch=master)](https://travis-ci.org/sindresorhus/has-flag)
|
||
|
|
||
|
> Check if [`argv`](https://nodejs.org/docs/latest/api/process.html#process_process_argv) has a specific flag
|
||
|
|
||
|
Correctly stops looking after an `--` argument terminator.
|
||
|
|
||
|
---
|
||
|
|
||
|
<div align="center">
|
||
|
<b>
|
||
|
<a href="https://tidelift.com/subscription/pkg/npm-has-flag?utm_source=npm-has-flag&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
|
||
|
</b>
|
||
|
<br>
|
||
|
<sub>
|
||
|
Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
|
||
|
</sub>
|
||
|
</div>
|
||
|
|
||
|
---
|
||
|
|
||
|
|
||
|
## Install
|
||
|
|
||
|
```
|
||
|
$ npm install has-flag
|
||
|
```
|
||
|
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
```js
|
||
|
// foo.js
|
||
|
const hasFlag = require('has-flag');
|
||
|
|
||
|
hasFlag('unicorn');
|
||
|
//=> true
|
||
|
|
||
|
hasFlag('--unicorn');
|
||
|
//=> true
|
||
|
|
||
|
hasFlag('f');
|
||
|
//=> true
|
||
|
|
||
|
hasFlag('-f');
|
||
|
//=> true
|
||
|
|
||
|
hasFlag('foo=bar');
|
||
|
//=> true
|
||
|
|
||
|
hasFlag('foo');
|
||
|
//=> false
|
||
|
|
||
|
hasFlag('rainbow');
|
||
|
//=> false
|
||
|
```
|
||
|
|
||
|
```
|
||
|
$ node foo.js -f --unicorn --foo=bar -- --rainbow
|
||
|
```
|
||
|
|
||
|
|
||
|
## API
|
||
|
|
||
|
### hasFlag(flag, [argv])
|
||
|
|
||
|
Returns a boolean for whether the flag exists.
|
||
|
|
||
|
#### flag
|
||
|
|
||
|
Type: `string`
|
||
|
|
||
|
CLI flag to look for. The `--` prefix is optional.
|
||
|
|
||
|
#### argv
|
||
|
|
||
|
Type: `string[]`<br>
|
||
|
Default: `process.argv`
|
||
|
|
||
|
CLI arguments.
|
||
|
|
||
|
|
||
|
## Security
|
||
|
|
||
|
To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure.
|
||
|
|
||
|
|
||
|
## License
|
||
|
|
||
|
MIT © [Sindre Sorhus](https://sindresorhus.com)
|