[license-shield-url]: https://img.shields.io/github/license/typeforce-js/is-boolean.svg?style=flat-square
[license-url]: https://github.com/Typeforce-JS/is-boolean/blob/master/LICENSE
[npm-downloads-shield-url]: https://img.shields.io/npm/dt/@typeforce/is-boolean.svg?style=flat-square
[npm-version-shield-url]: https://img.shields.io/npm/v/@typeforce/is-boolean.svg?style=flat-square
[npm-url]: https://www.npmjs.com/package/@typeforce/is-boolean
[unpkg-shield-url]: https://img.shields.io/badge/unpkg-up--to--date-brightgreen.svg?style=flat-square
[unpkg-url]: https://unpkg.com/@typeforce/is-boolean/dist/index.min.js

is-boolean

[![NPM][npm-version-shield-url]][npm-url]
[![NPM][npm-downloads-shield-url]][npm-url]
[![CDN][unpkg-shield-url]][unpkg-url]
[![LICENSE][license-shield-url]][license-url]

Determine if a value is a boolean.

A value is a boolean if it is of primitive type boolean, or is an instance of
reference type Boolean.

Usage

``shell
npm install @typeforce/is-boolean --save # Install package via NPM
`

`javascript
import { expect } from "chai";
import isBoolean from "@typeforce/is-boolean";

expect(isBoolean(true)).to.be.true;
expect(isBoolean(false)).to.be.true;
expect(isBoolean(new Boolean(true))).to.be.true;

expect(isBoolean(undefined)).to.be.false;
expect(isBoolean(null)).to.be.false;
expect(isBoolean("true").to.be.false;
expect(isBoolean(1)).to.be.false;
`

This package contains TypeScript type declarations. Furthermore, the package
uses TypeScript type guards to allow type inference to influence IntelliSense.

`typescript
if (isBoolean(x)) {
// IntelliSense now knows x is a boolean.
let y: boolean = x;
}
`

$3

This package can be imported via unpkg as demonstrated
below.

`html


`

Build & Test

When building the project, a folder named dist/ will be created if it does not
already exist, where the compiled code will be outputted to. Type declaration
files will also be generated and outputted to the dist/ folder.

A minified Javascript version of the entire project will be generated and
outputted to dist/index.min.js.

`shell
npm install # Installs dependencies.
npm run build # Build the project.
`

This package uses Gulp for building, and Chai
and Mocha for testing.

`shell
npm test # Run tests.
`

License

Refer to the LICENSE` file for license information.