модуль утверждает

Утвердите тестовый модуль, если тестовое значение ложно, он сообщит об ошибке, и поведение сообщения об ошибке может быть установлено для продолжения работы или выдачи ошибки.

Справочный метод:

1
var assert = require('assert');

или черезtestСсылка на модуль:

1
2
var test = require('test');
var assert = test.assert;

или черезtest.setupКонфигурация:

1
require("test").setup();

статическая функция

Function

Тестовое значение истинно, утверждение не выполняется, если оно ложно.

1
2
static assert.Function(Value actual = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

ok

Тестовое значение истинно, утверждение не выполняется, если оно ложно.

1
2
static assert.ok(Value actual = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

notOk

Тестовое значение ложно, утверждение не выполняется, если оно верно

1
2
static assert.notOk(Value actual = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

equal

Тестовое значение равно ожидаемому, в противном случае утверждение не выполняется.

1
2
3
static assert.equal(Value actual = undefined,
    Value expected = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

notEqual

Тестовое значение не равно ожидаемому значению, и утверждение не выполняется, если они равны

1
2
3
static assert.notEqual(Value actual = undefined,
    Value expected = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

strictEqual

Тестовое значение строго равно ожидаемому значению, в противном случае утверждение не выполняется.

1
2
3
static assert.strictEqual(Value actual = undefined,
    Value expected = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

notStrictEqual

Тестовое значение не строго равно ожидаемому значению, в противном случае утверждение не выполняется.

1
2
3
static assert.notStrictEqual(Value actual = undefined,
    Value expected = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

deepEqual

Глубина тестового значения равна ожидаемому значению, в противном случае утверждение не выполняется.

1
2
3
static assert.deepEqual(Value actual = undefined,
    Value expected = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

notDeepEqual

Тестовое значение не глубоко равно ожидаемому значению, и если оно равно, утверждение не выполняется.

1
2
3
static assert.notDeepEqual(Value actual = undefined,
    Value expected = undefined,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

closeTo

Тестовое значение приблизительно равно ожидаемому значению, в противном случае утверждение не выполняется.

1
2
3
4
static assert.closeTo(Value actual,
    Value expected,
    Value delta,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
delta: Значение, приблизительная десятичная точность
msg: Строка, сообщение, когда утверждение терпит неудачу

notCloseTo

Тестовое значение приблизительно не равно ожидаемому значению, в противном случае утверждение не выполняется.

1
2
3
4
static assert.notCloseTo(Value actual,
    Value expected,
    Value delta,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
delta: Значение, приблизительная десятичная точность
msg: Строка, сообщение, когда утверждение терпит неудачу

lessThan

Тестовое значение меньше ожидаемого, и утверждение не выполняется, если оно больше или равно

1
2
3
static assert.lessThan(Value actual,
    Value expected,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

notLessThan

Тестовое значение не меньше ожидаемого, если оно меньше, утверждение не выполняется

1
2
3
static assert.notLessThan(Value actual,
    Value expected,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

greaterThan

Тестовое значение больше, чем ожидаемое значение, и утверждение не выполняется, если оно меньше или равно

1
2
3
static assert.greaterThan(Value actual,
    Value expected,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

notGreaterThan

Тестовое значение не превышает ожидаемого значения, если оно больше, чем утверждение не выполняется.

1
2
3
static assert.notGreaterThan(Value actual,
    Value expected,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
expected: значение, ожидаемое значение
msg: Строка, сообщение, когда утверждение терпит неудачу

exist

Проверить, что переменная существует, false, если утверждение не выполняется

1
2
static assert.exist(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

notExist

Тестовая переменная не существует, утверждение не выполняется, если оно истинно

1
2
static assert.notExist(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isTrue

Проверяет, что значение является логическим значением true, в противном случае утверждение не выполняется.

1
2
static assert.isTrue(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotTrue

Проверьте, что значение не является логическим значением true, иначе утверждение не выполняется.

1
2
static assert.isNotTrue(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isFalse

Тестовое значение — логическое значение false, в противном случае утверждение не выполняется.

1
2
static assert.isFalse(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotFalse

Проверяет, что значение не является логическим значением false, в противном случае утверждение не выполняется.

1
2
static assert.isNotFalse(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNull

Тестовое значение равно Null, в противном случае утверждение не выполняется.

1
2
static assert.isNull(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotNull

Тестовое значение не равно Null, в противном случае утверждение не выполняется.

1
2
static assert.isNotNull(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isUndefined

Тестовое значение не определено, в противном случае утверждение не выполняется.

1
2
static assert.isUndefined(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isDefined

Тестовое значение не неопределенно, в противном случае утверждение не выполняется.

1
2
static assert.isDefined(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isFunction

Тестовое значение является функцией, в противном случае утверждение не выполняется.

1
2
static assert.isFunction(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotFunction

Проверьте, что значение не является функцией, иначе утверждение не выполняется.

1
2
static assert.isNotFunction(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isObject

Тестовое значение является объектом, в противном случае утверждение не выполняется.

1
2
static assert.isObject(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotObject

Тестовое значение не является объектом, иначе утверждение не выполняется.

1
2
static assert.isNotObject(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isArray

Тестовое значение представляет собой массив, в противном случае утверждение не выполняется.

1
2
static assert.isArray(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotArray

Тестовое значение не является массивом, иначе утверждение не выполняется.

1
2
static assert.isNotArray(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isString

Тестовое значение представляет собой строку, в противном случае утверждение не выполняется.

1
2
static assert.isString(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotString

Проверьте, что значение не является строкой, иначе утверждение не выполняется.

1
2
static assert.isNotString(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNumber

Проверьте, что значение является числом, иначе утверждение не выполняется.

1
2
static assert.isNumber(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotNumber

Проверьте, что значение не является числом, иначе утверждение не выполняется.

1
2
static assert.isNotNumber(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isBoolean

Значение теста логическое, в противном случае утверждение завершается ошибкой.

1
2
static assert.isBoolean(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

isNotBoolean

Проверьте, что значение не является логическим, иначе утверждение не выполняется.

1
2
static assert.isNotBoolean(Value actual,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

typeOf

Проверяет, что значение имеет заданный тип, в противном случае утверждение не выполняется.

1
2
3
static assert.typeOf(Value actual,
    String type,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
type: Строка указанного типа
msg: Строка, сообщение, когда утверждение терпит неудачу

notTypeOf

Проверяет, что значение не имеет заданного типа, в противном случае утверждение не выполняется.

1
2
3
static assert.notTypeOf(Value actual,
    String type,
    String msg = "");

Параметры вызова:

actual: Значение, значение для проверки
type: Строка указанного типа
msg: Строка, сообщение, когда утверждение терпит неудачу

property

Объект теста содержит указанное свойство, в противном случае утверждение не выполняется.

1
2
3
static assert.property(Value object,
    Value prop,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

notProperty

Объект теста не содержит указанный атрибут, иначе утверждение не выполняется.

1
2
3
static assert.notProperty(Value object,
    Value prop,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки
msg: Строка, сообщение, когда утверждение терпит неудачу

deepProperty

Объект проверки глубины содержит указанное свойство, в противном случае утверждение не выполняется.

1
2
3
static assert.deepProperty(Value object,
    Value prop,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки, разделенное знаком "."
msg: Строка, сообщение, когда утверждение терпит неудачу

notDeepProperty

Объект проверки глубины не содержит указанного атрибута, в противном случае утверждение не выполняется.

1
2
3
static assert.notDeepProperty(Value object,
    Value prop,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки, разделенное знаком "."
msg: Строка, сообщение, когда утверждение терпит неудачу

propertyVal

Значение указанного свойства в тестовом объекте является заданным значением, в противном случае утверждение не выполняется.

1
2
3
4
static assert.propertyVal(Value object,
    Value prop,
    Value value,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки
value: Значение, заданное значение
msg: Строка, сообщение, когда утверждение терпит неудачу

propertyNotVal

Значение указанного свойства в тестовом объекте не является заданным значением, в противном случае утверждение не выполняется.

1
2
3
4
static assert.propertyNotVal(Value object,
    Value prop,
    Value value,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки
value: Значение, заданное значение
msg: Строка, сообщение, когда утверждение терпит неудачу

deepPropertyVal

Значение указанного свойства в объекте проверки глубины является заданным значением, в противном случае утверждение не выполняется.

1
2
3
4
static assert.deepPropertyVal(Value object,
    Value prop,
    Value value,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки, разделенное знаком "."
value: Значение, заданное значение
msg: Строка, сообщение, когда утверждение терпит неудачу

deepPropertyNotVal

Значение указанного свойства в объекте проверки глубины не является заданным значением, в противном случае утверждение не выполняется.

1
2
3
4
static assert.deepPropertyNotVal(Value object,
    Value prop,
    Value value,
    String msg = "");

Параметры вызова:

object: значение, объект для проверки
prop: значение, свойство для проверки, разделенное знаком "."
value: Значение, заданное значение
msg: Строка, сообщение, когда утверждение терпит неудачу

throws

Тестирование данного кода вызовет ошибку, в противном случае утверждение не будет выполнено.

1
2
static assert.throws(Function block,
    String msg = "");

Параметры вызова:

block: функция, указывает код для тестирования, заданный как функция
msg: Строка, сообщение, когда утверждение терпит неудачу

doesNotThrow

Проверьте, что данный код не выдает ошибку, если это так, утверждение не выполняется.

1
2
static assert.doesNotThrow(Function block,
    String msg = "");

Параметры вызова:

block: функция, указывает код для тестирования, заданный как функция
msg: Строка, сообщение, когда утверждение терпит неудачу

ifError

Выдает, если аргумент верен

1
static assert.ifError(Value object = undefined);

Параметры вызова:

object: Значение, параметр

Руководство по разработке

базовый модуль

встроенные объекты

модуль сообщества

модуль утверждает

статическая функция

Function

ok

notOk

equal

notEqual

strictEqual

notStrictEqual

deepEqual

notDeepEqual

closeTo

notCloseTo

lessThan

notLessThan

greaterThan

notGreaterThan

exist

notExist

isTrue

isNotTrue

isFalse

isNotFalse

isNull

isNotNull

isUndefined

isDefined

isFunction

isNotFunction

isObject

isNotObject

isArray

isNotArray

isString

isNotString

isNumber

isNotNumber

isBoolean

isNotBoolean

typeOf

notTypeOf

property

notProperty

deepProperty

notDeepProperty

propertyVal

propertyNotVal

deepPropertyVal

deepPropertyNotVal

throws

doesNotThrow

ifError