Skip to main content

assert

Functions

Perform a value typeof === type check and throw an error if the type does not match. For static cases, prefer to use specific type-checking functions such as isString or isNumber.

equal(a, b, [m])

Kind: global function

ParamType
aT
bT
[m]string

notEqual(a, b, [m])

Kind: global function

ParamType
aT
bT
[m]string

notOk(t, [m])

Kind: global function

ParamType
tboolean
[m]string

logicalEquals(a, b, [m])

Kind: global function

ParamType
aobject
bobject
[m]string

assert(t, [m])

Kind: global function

ParamType
tboolean
[m]string

assert.isFiniteNumber

use isFinite instead

Alias

Kind: static property of assert

assert.enum(value, enumerable, [name])

Kind: static method of assert

ParamType
valueT
enumerableObject.<T>
[name]string

assert.isInstanceOf(value, klass, [value_name], [class_name])

Kind: static method of assert

ParamType
value*
klassClass
[value_name]string
[class_name]string

assert.isNumber(value, [name])

Kind: static method of assert

ParamType
valuenumber | *
[name]string

assert.isString(value, [name])

Kind: static method of assert

ParamType
valuestring | *
[name]string

assert.isBoolean(value, [name])

Kind: static method of assert

ParamType
valueboolean | *
[name]string

assert.isFunction(value, [name])

Kind: static method of assert

ParamType
valuefunction | *
[name]string

assert.isObject(value, [name])

Kind: static method of assert

ParamType
valueObject | *
[name]string

assert.isInteger(value, [name])

Kind: static method of assert

ParamType
valuenumber | *
[name]string

assert.isNonNegativeInteger(value, [name])

Kind: static method of assert

ParamType
valuenumber | *
[name]string

assert.isArray(value, name)

Kind: static method of assert

ParamType
valueArray.<T>
namestring

assert.isArrayLike(value, name)

Kind: static method of assert

ParamType
valueArrayLike.<T> | Array.<T> | Uint32Array | Float32Array
namestring

assert.defined(value, [name])

Check for value !== undefined, throws exception if value is undefined

Kind: static method of assert

ParamType
value*
[name]String

assert.undefined(value, [name])

Checks for value === undefined, throws exception if value is NOT undefined

Kind: static method of assert

ParamType
value*
[name]String

assert.isNull(value, [name])

Kind: static method of assert

ParamType
value*
[name]String

assert.notNull(value, [name])

Kind: static method of assert

ParamType
value*
[name]String

assert.notNaN(value, name)

Kind: static method of assert

ParamType
valuenumber
namestring

assert.isFinite(value, [name])

Is the given number finite? Will trigger if the number is infinite, i.e. fails the Number.isFinite test

Kind: static method of assert

ParamTypeDescription
valuenumber
[name]stringoptional name for the value being checked

assert.that(value, name, matcher)

More powerful and flexible assertion API based on matchers. Allows complex matching criteria to be constructed.

see Matcher

Kind: static method of assert

ParamType
valueT
namestring
matcherMatcher.<T>

Example

assert.that(value,'value', anyOf(isNull(),isUndefined())); // will trigger iff !(value === undefined || value === null)
assert.that(value, 'value', isOneOf([3,7])); // will only trigger iff !(value === 3 || value === 7)

greaterThan(a, b, [m])

Kind: global function

ParamType
anumber
bnumber
[m]string

lessThan(a, b, [m])

Kind: global function

ParamType
anumber
bnumber
[m]string

greaterThanOrEqual(a, b, [m])

Kind: global function

ParamType
anumber
bnumber
[m]string

lessThanOrEqual(a, b, [m])

Kind: global function

ParamType
anumber
bnumber
[m]string

isOneOf(value, options, [name])

Kind: global function

ParamTypeDefaultDescription
valueT
optionsArray.<T>must be string-serializable for useful error messages
[name]string"value"optional name for a better error message

typeOf(value, type, valueName)

Perform a value typeof === type check and throw an error if the type does not match. For static cases, prefer to use specific type-checking functions such as isString or isNumber.

Kind: global function

ParamTypeDefault
value*
typestring
valueNamestring"value"

arrayHas(haystack, needle, [message])

Kind: global function

ParamTypeDefault
haystackArray.<T>
needleT
[message]string"Array does not contain the item"

arrayHasNo(haystack, needle, [message])

Kind: global function

ParamTypeDefault
haystackArray.<T>
needleT
[message]string"Array contains the item"

arrayEqual(a, b, [message])

Kind: global function

ParamTypeDefault
aArray.<T> | ArrayLike.<T> | Float32Array | Int32Array
bArray.<T> | ArrayLike.<T> | Float32Array | Int32Array
[message]string"Arrays are not equal"