# dis-isa

> isa types for javascript

Latest version **1.4.3** (published 2020-11-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install dis-isa
pnpm add dis-isa
yarn add dis-isa
bun add dis-isa
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.4.3 |
| Published | 2020-11-23 |
| First published | 2015-07-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 18.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Miguel Castillo |
| Maintainers | manchagnu |

## Links

- npm: https://www.npmjs.com/package/dis-isa
- Repository: https://github.com/MiguelCastillo/dis-isa
- Issues: https://github.com/MiguelCastillo/dis-isa/issues
- npm.io page: https://npm.io/package/dis-isa

## Recent versions

- 1.4.3 (latest) — 2020-11-23
- 1.4.2 — 2020-11-23
- 1.4.1 — 2020-11-22
- 1.4.0 — 2020-11-22
- 1.3.2 — 2018-01-18
- 1.3.1 — 2018-01-18
- 1.3.0 — 2017-06-06
- 1.2.3 — 2016-04-09
- 1.2.2 — 2015-08-14
- 1.2.1 — 2015-08-14
- 1.2.0 — 2015-08-04
- 1.1.0 — 2015-08-04
- 1.0.0 — 2015-07-27

## README

## dis isa

> isa types for javascript

### API


#### isBoolean(any) : boolean

Method that takes in a value and returns whether or not it is boolean.

``` javascript
import types from 'dis-isa';

types.isBoolean(true); // true
types.isBoolean(false); // true
types.isBoolean(1); // false
types.isBoolean(undefined); // false
```

#### isUndefined(any) : boolean

Method that takes an input and returns whether or not it is `undefined`.

``` javascript
import types from 'dis-isa';

types.isUndefined(1); // false
types.isUndefined(undefined); // true
```

#### isNull(any) : boolean

Method that takes an input and returns whether or not it is `null`

``` javascript
import types from 'dis-isa';

types.isNull(1); // false
types.isNull(null); // true
types.isNull(undefined); // false
```

#### isRegex(any) : boolean

Method that takes an input and returns whether or not it is a regular expression

``` javascript
import types from 'dis-isa';

types.isRegex(1); // false
types.isRegex(/some/); // true
types.isRegex(new RegExp('some')); // true
```

#### isArray(any) : boolean

Method that takes an input and returns whether or not it is an array. The check will try to default to the built in `isArray` if available, otherwise an equivalent check is performed.

``` javascript
import types from 'dis-isa';

types.isArray(1); // false
types.isArray([]); // true
types.isArray(new Array()); // true
```

#### isFunction(any) : boolean

Method that takes an input and returns whether or not it is a function.

``` javascript
import types from 'dis-isa';

function test() {
}

types.isFunction(1); // false
types.isFunction(test); // true
types.isFunction(new test()); // false
```

#### isString(any) : boolean

Method that takes an input and returns whether or not it is a string.

``` javascript
import types from 'dis-isa';

types.isString(1); // false
types.isString("test"); // true
types.isString(new String("test")); // true
```

#### isDate(any) : boolean

Method that takes an input and returns whether or not it is a Date.

``` javascript
import types from 'dis-isa';

types.isDate(1); // false
types.isDate("test"); // false
types.isDate(new Date()); // true
```

#### isObject(any) : boolean

Method that takes an input and returns whether or not it is an object. And object is any one of the following:
- literal object
- object instance
- array
- null

``` javascript
import types from 'dis-isa';

types.isObject(1); // false
types.isObject("test"); // true
types.isObject(new String("test")); // true
types.isObject(null); // true
```

#### isPlainObject(any) : boolean

Method that takes an input and returns whether or not it is a plain object. A plain object can be:
- A literal object. `{}`
- Objects created with `new Object()` and `Object.create`

``` javascript
import types from 'dis-isa';

types.isPlainObject(1); // false
types.isPlainObject("test"); // false
types.isPlainObject(new Object()); // true
types.isPlainObject(Object.create(null)); // true
types.isPlainObject({}); // true
```

#### isError(any) : boolean

Method that takes an input and returns whether or not it is an Error. Errors are instances of `Error`, including exceptions.

``` javascript
import types from 'dis-isa';

var err = new Error();

types.isError(1); // false
types.isError(err); // true
```

#### typeName(any) : string

Method that takes an input and returns its string type representation. The string type is all lower case. Useful for extending the supported types.

``` javascript
import types from 'dis-isa';

types.typeName(1); // 'number'
types.typeName(null); // 'null'
types.typeName(function() {}); // 'function'
```

#### toString(any) : string

Method that takes an input and returns the raw type signature. Useful for extending the supported types.

``` javascript
import types from 'dis-isa';

types.toString(1); // '[object Number]'
types.toString(null); // '[object Null]'
types.toString(function() {}); // '[object Function]'
```


### Licensed under MIT

---
_Source: https://npm.io/package/dis-isa · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
