diff options
author | LinuxWizard42 <computerwizard@linuxmail.org> | 2022-10-12 22:54:37 +0300 |
---|---|---|
committer | LinuxWizard42 <computerwizard@linuxmail.org> | 2022-10-12 22:54:37 +0300 |
commit | 703e03aba33f234712206769f57717ba7d92d23d (patch) | |
tree | 0041f04ccb75bd5379c764e9fe42249fffe75fc3 /node_modules/boolean/README.md | |
parent | ab6e257e6e9d9a483d7e86f220d8b209a2cd7753 (diff) | |
download | FlashRunner-703e03aba33f234712206769f57717ba7d92d23d.tar.gz FlashRunner-703e03aba33f234712206769f57717ba7d92d23d.tar.zst |
Added export_allowed file to make repository visible in cgit
Diffstat (limited to 'node_modules/boolean/README.md')
-rw-r--r-- | node_modules/boolean/README.md | 95 |
1 files changed, 95 insertions, 0 deletions
diff --git a/node_modules/boolean/README.md b/node_modules/boolean/README.md new file mode 100644 index 0000000..11fe8e5 --- /dev/null +++ b/node_modules/boolean/README.md @@ -0,0 +1,95 @@ +# boolean + +boolean converts lots of things to boolean. + +## Status + +| Category | Status | +| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | +| Version | [](https://www.npmjs.com/package/boolean) | +| Dependencies |  | +| Dev dependencies |  | +| Build |  | +| License |  | + +## Installation + +```shell +$ npm install boolean +``` + +## Quick start + +First you need to add a reference to boolean in your application: + +```javascript +const { boolean, isBooleanable } = require('boolean'); +``` + +If you use TypeScript, use the following code instead: + +```typescript +import { boolean, isBooleanable } from 'boolean'; +``` + +To verify a value for its boolean value, call the `boolean` function and provide the value in question as parameter: + +```javascript +console.log(boolean('true')); // => true +``` + +The `boolean` function considers the following values to be equivalent to `true`: + +- `true` (boolean) +- `'true'` (string) +- `'TRUE'` (string) +- `'t'` (string) +- `'T'` (string) +- `'yes'` (string) +- `'YES'` (string) +- `'y'` (string) +- `'Y'` (string) +- `'on'` (string) +- `'ON'` (string) +- `'1'` (string) +- `1` (number) + +In addition to the primitive types mentioned above, boolean also supports their object wrappers `Boolean`, `String`, and `Number`. + +_Please note that if you provide a `string` or a `String` object, it will be trimmed._ + +All other values, including `undefined` and `null` are considered to be `false`. + +### Figuring out whether a value can be considered to be boolean + +From time to time, you may not want to directly convert a value to its boolean equivalent, but explicitly check whether it looks like a boolean. E.g., although `boolean('F')` returns `false`, the string `F` at least looks like a boolean, in contrast to something such as `123` (for which `boolean(123)` would also return `false`). + +To figure out whether a value can be considered to be a boolean, use the `isBooleanable` function: + +```javascript +console.log(isBooleanable('true')); // => true +``` + +The `isBooleanable` function considers all of the above mentioned values to be reasonable boolean values, and additionally, also the following ones: + +- `false` (boolean) +- `'false'` (string) +- `'FALSE'` (string) +- `'f'` (string) +- `'F'` (string) +- `'no'` (string) +- `'NO'` (string) +- `'n'` (string) +- `'N'` (string) +- `'off'` (string) +- `'OFF'` (string) +- `'0'` (string) +- `0` (number) + +## Running quality assurance + +To run quality assurance for this module use [roboter](https://www.npmjs.com/package/roboter): + +```shell +$ npx roboter +``` |