Модуль assert

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

Эталонный метод:

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 : String, подсказка при сбое утверждения

ok

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

notOk

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

equal

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

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

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

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

notEqual

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

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

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

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

strictEqual

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

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

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

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

notStrictEqual

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

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

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

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

deepEqual

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

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

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

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

notDeepEqual

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

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

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

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

closeTo

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

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

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

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

notCloseTo

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

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

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

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

lessThan

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

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

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

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

notLessThan

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

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

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

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

greaterThan

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

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

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

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

notGreaterThan

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

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

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

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

exist

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

notExist

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isTrue

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotTrue

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isFalse

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotFalse

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNull

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotNull

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isUndefined

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isDefined

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isFunction

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotFunction

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isObject

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotObject

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isArray

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotArray

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isString

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotString

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNumber

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotNumber

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isBoolean

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

isNotBoolean

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

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

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

actual : значение, значение для проверки.
msg : String, подсказка при сбое утверждения

typeOf

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

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

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

actual : значение, значение для проверки.
type : String, указанный тип
msg : String, подсказка при сбое утверждения

notTypeOf

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

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

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

actual : значение, значение для проверки.
type : String, указанный тип
msg : String, подсказка при сбое утверждения

property

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

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

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

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

notProperty

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

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

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

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

deepProperty

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

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

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

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

notDeepProperty

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

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

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

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

propertyVal

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

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

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

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

propertyNotVal

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

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

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

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

deepPropertyVal

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

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

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

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

deepPropertyNotVal

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

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

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

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

throws

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

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

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

block : Функция, укажите тестовый код, заданный в виде функции
msg : String, подсказка при сбое утверждения

doesNotThrow

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

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

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

block : Функция, укажите тестовый код, заданный в виде функции
msg : String, подсказка при сбое утверждения

ifError

Если параметр истинен, бросить

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

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

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

Руководство по развитию

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

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

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

Модуль assert

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

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