# @magic-libraries/is

> @magic-libraries/is type checking module. unifies type checking apis.

Latest version **0.0.8** (published 2023-09-20) · AGPL-3.0 license · 0 weekly downloads

## Install

```sh
npm install @magic-libraries/is
pnpm add @magic-libraries/is
yarn add @magic-libraries/is
bun add @magic-libraries/is
```

## Health

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

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.8 |
| Published | 2023-09-20 |
| First published | 2019-12-07 |
| Weekly downloads | 0 |
| License | AGPL-3.0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=14.15.4 |
| Dependencies | 0 |
| Unpacked size | 38.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Wizards & Witches |
| Maintainers | jascha |
| Keywords | magic, is, types, client, browser, magic-libraries, hyperapp |

## Links

- npm: https://www.npmjs.com/package/@magic-libraries/is
- Repository: https://github.com/magic-libraries/is
- Homepage: https://magic-libraries.github.io/is/
- Issues: https://github.com/magic-libraries/is/issues
- npm.io page: https://npm.io/package/@magic-libraries/is

## Recent versions

- 0.0.8 (latest) — 2023-09-20
- 0.0.7 — 2022-04-02
- 0.0.6 — 2021-01-17
- 0.0.5 — 2020-05-07
- 0.0.4 — 2020-01-08
- 0.0.3 — 2019-12-07
- 0.0.2 — 2019-12-07
- 0.0.1 — 2019-12-07

## README

## @magic-libraries/is

typechecking client lib for
[@magic](https://magic.github.io/core)

[html-docs](https://magic-libraries.github.io/is)

[![NPM version][npm-image]][npm-url]
[![Linux Build Status][travis-image]][travis-url]
[![Windows Build Status][appveyor-image]][appveyor-url]
[![Coverage Status][coveralls-image]][coveralls-url]
[![Greenkeeper badge][greenkeeper-image]][greenkeeper-url]
[![Known Vulnerabilities][snyk-image]][snyk-url]

[npm-image]: https://img.shields.io/npm/v/@magic-libraries/is.svg
[npm-url]: https://www.npmjs.com/package/@magic-libraries/is
[travis-image]: https://img.shields.io/travis/com/magic-libraries/is/master
[travis-url]: https://travis-ci.com/magic-libraries/is
[appveyor-image]: https://img.shields.io/appveyor/ci/magiclibraries/is/master.svg
[appveyor-url]: https://ci.appveyor.com/project/magiclibraries/is/branch/master
[coveralls-image]: https://coveralls.io/repos/github/magic-libraries/is/badge.svg
[coveralls-url]: https://coveralls.io/github/magic-libraries/is
[greenkeeper-image]: https://badges.greenkeeper.io/magic-libraries/is.svg
[greenkeeper-url]: https://badges.greenkeeper.io/magic-libraries/is.svg
[snyk-image]: https://snyk.io/test/github/magic-libraries/is/badge.svg
[snyk-url]: https://snyk.io/test/github/magic-libraries/is

- [installation](#install)
- [usage](#usage)
- [supported types](#types)

#### <a name="install"></a>installation

```bash
npm install --save-exact @magic-libraries/is
```

#### <a name="usage"></a>usage

in a page/component, just use the LIB.JSON functions.

```javascript
export const View = () => [
  div(LIB.IS('a string', 'string') ? '"a string" is a string' : '"a string" is not a string'),
  div(LIB.IS(0, 'string') ? '0 is a string' : '0 is not a string'),
]
```

renders

```html
<div>"a string" is a string</div>
<div>0 is not a string</div>
```

#### <a name="types"></a>supported types

by default, magic will test for type equality using typeof.

```javascript
is('a string', 'string') // true
is({}, 'object') // true
is([], 'object') // true
```

if typeof would fail, is uses a number of builtin functions to determine the type of the value

```javascript
is([], 'array') // true
is(0, 'number') // true
is(1.1, 'float') // true
is(10, 'integer') // true
is(new Date(), 'date') // true
is(/regexp/, 'regexp') // true
is(new Error(), 'error') // true
is(null, 'null') // true
is(new Promise(), 'promise') // true
is({}, 'objectNative') //true
```

for convenience, @magic-libraries/is also exports the alias functions it uses

```javascript
is.number(0) // true
is.integer(1) // true
is.float(1.1) // true
is.array([]) // true
is.regexp(/t/) // true
is.date(new Date()) // true
is.error(new Error()) // true
is.null(null) // true
is.promise(new Promise()) // true
is.objectNative({}) //true
```

#### changelog

##### 0.0.1

first release

##### 0.0.2

update readme

##### 0.0.3

update readme

##### 0.0.4

require node 13.5.0

##### 0.0.5

bump required node version

##### 0.0.6

bump required node version to 14.15.4

##### 0.0.7

update dependencies

##### 0.0.8

update dependencies
add is.objectNative

##### 0.0.9 - unreleased

...

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