check-types.js

A small JavaScript library for checking types and throwing exceptions.

Installation

Node.js

npm install check-types

Browser

git clone [email protected]:philbooth/check-types.js.git

Usage

Loading the library

Node.js

var check = require('check-types');

Browser

<script type="text/javascript" src=".../check-types.js/src/check-types.min.js"></script>

Calling the exported functions

A number of different functions are exported:

check.quacksLike (thing, duck)

Tests whether an object 'quacks like a duck'. Returns true if the first argument has all of the properties of the second, archetypal argument (the 'duck'). Returns false otherwise. If either argument is not an object, an exception is thrown.

check.isInstance (thing, prototype)

Returns true if an object is an instance of a prototype, false otherwise.

check.verifyInstance (thing, prototype, message)

Throws an exception if an object is not an instance of a prototype.

check.isObject (thing)

Returns true if something is a non-null, non-array object, false otherwise.

check.verifyObject (thing, message)

Throws an exception unless something is a non-null, non-array object.

check.isArray (thing)

Returns true something is an array, false otherwise.

check.verifyArray (thing, message)

Throws an exception unless something is an array.

check.isFunction (thing)

Returns true if something is function, false otherwise.

check.verifyFunction (thing, message)

Throws an exception unless something is function.

check.isUnemptyString (thing)

Returns true if something is a non-empty string, false otherwise.

check.verifyUnemptyString (thing, message)

Throws an exception unless something is a non-empty string.

check.isString (thing)

Returns true if something is a string, false otherwise.

check.verifyString (thing, message)

Throws an exception unless something is a string.

check.isNumber (thing)

Returns true if something is a number, false otherwise. In this instance, NaN is not considered a number.

check.verifyNumber (thing, message)

Throws an exception unless something is a number. In this instance, NaN is not considered a number.

Development

Dependencies

The build environment relies on Node.js, NPM, Jake, JSHint, Mocha, Chai and UglifyJS. Assuming that you already have Node.js and NPM set up, you just need to run npm install to install all of the dependencies as listed in package.json.

Unit tests

The unit tests are in test/check-types.coffee. You can run them with the command npm test or jake jstest.