Пространство имён: matchers

matchers

Матчеры, поставляемые Jasmine по умолчанию.

Члены

not :matchers

Инвертирует матчер, следуя expect

Тип:

matchers

С тех пор:

1.3.0

Пример

expect(something).not.toBe(true);

Методы

nothing()

expect явное указание ничего.

С тех пор:

2.8.0

Пример

expect().nothing();

toBe(expected)

expect фактическое значение должно быть === ожидаемому значению.

Параметры:

Имя	Тип	Описание
`expected`	Object	Ожидаемое значение для сравнения.

С тех пор:

1.3.0

Пример

expect(thing).toBe(realThing);

toBeCloseTo(expected, precisionopt)

expect фактическое значение должно находиться в пределах указанной точности от ожидаемого значения.

Параметры:

Имя	Тип	Атрибуты	По умолчанию	Описание
`expected`	Object			Ожидаемое значение для сравнения.
`precision`	Number	<необязательно>	2	Количество знаков после запятой для проверки.

С тех пор:

1.3.0

Пример

expect(number).toBeCloseTo(42.2, 3);

toBeDefined()

expect фактическое значение должно быть определено. (Не undefined)

С тех пор:

1.3.0

Пример

expect(result).toBeDefined();

toBeFalse()

expect фактическое значение должно быть false.

С тех пор:

3.5.0

Пример

expect(result).toBeFalse();

toBeFalsy()

expect фактическое значение должно быть ложным

С тех пор:

2.0.0

Пример

expect(result).toBeFalsy();

toBeGreaterThan(expected)

expect фактическое значение должно быть больше ожидаемого значения.

Параметры:

Имя	Тип	Описание
`expected`	Number	Значение для сравнения.

С тех пор:

2.0.0

Пример

expect(result).toBeGreaterThan(3);

toBeGreaterThanOrEqual(expected)

expect фактическое значение должно быть больше или равно ожидаемому значению.

Параметры:

Имя	Тип	Описание
`expected`	Number	Ожидаемое значение для сравнения.

С тех пор:

2.0.0

Пример

expect(result).toBeGreaterThanOrEqual(25);

toBeInstanceOf(expected)

expect фактическое значение должно быть экземпляром ожидаемого класса

Параметры:

Имя	Тип	Описание
`expected`	Объект	Класс или функция-конструктор для проверки.

С версии:

3.5.0

Пример

expect('foo').toBeInstanceOf(String);
expect(3).toBeInstanceOf(Number);
expect(new Error()).toBeInstanceOf(Error);

toBeLessThan(ожидаемое)

expect фактическое значение меньше ожидаемого.

Параметры:

Имя	Тип	Описание
`expected`	Число	Ожидаемое значение для сравнения.

С версии:

2.0.0

Пример

expect(result).toBeLessThan(0);

toBeLessThanOrEqual(ожидаемое)

expect фактическое значение меньше или равно ожидаемому.

Параметры:

Имя	Тип	Описание
`expected`	Число	Ожидаемое значение для сравнения.

С версии:

2.0.0

Пример

expect(result).toBeLessThanOrEqual(123);

toBeNaN()

expect фактическое значение является NaN (Not a Number).

С версии:

1.3.0

Пример

expect(thing).toBeNaN();

toBeNegativeInfinity()

expect фактическое значение является -Infinity (-бесконечность).

С версии:

2.6.0

Пример

expect(thing).toBeNegativeInfinity();

toBeNull()

expect фактическое значение является null.

С версии:

1.3.0

Пример

expect(result).toBeNull();

toBePositiveInfinity()

expect фактическое значение является Infinity (бесконечность).

С версии:

2.6.0

Пример

expect(thing).toBePositiveInfinity();

toBeTrue()

expect фактическое значение является true.

С версии:

3.5.0

Пример

expect(result).toBeTrue();

toBeTruthy()

expect фактическое значение является истинным.

С версии:

2.0.0

Пример

expect(thing).toBeTruthy();

toBeUndefined()

expect фактическое значение является undefined.

С версии:

1.3.0

Пример

expect(result).toBeUndefined():

toContain(ожидаемое)

expect фактическое значение содержит конкретное значение.

Параметры:

Имя	Тип	Описание
`expected`	Объект	Искомое значение.

С версии:

2.0.0

Пример

expect(array).toContain(anElement);
expect(string).toContain(substring);

toEqual(ожидаемое)

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

Параметры:

Имя	Тип	Описание
`expected`	Объект	Ожидаемое значение

С момента:

1.3.0

Пример

expect(bigObject).toEqual({"foo": ['bar', 'baz']});

toHaveBeenCalled()

expect фактическое значение (шпион) было вызвано.

С момента:

1.3.0

Пример

expect(mySpy).toHaveBeenCalled();
expect(mySpy).not.toHaveBeenCalled();

toHaveBeenCalledBefore(expected)

expect фактическое значение (шпион) было вызвано до другого шпиона.

Параметры:

Имя	Тип	Описание
`expected`	Шпион	Шпион, который должен был быть вызван после шпиона.

С момента:

2.6.0

Пример

expect(mySpy).toHaveBeenCalledBefore(otherSpy);

toHaveBeenCalledOnceWith()

expect фактическое значение (шпион) было вызвано ровно один раз с указанными аргументами.

Параметры:

Тип	Атрибуты	Описание
Объект	<repeatable>	Искомые аргументы

С момента:

3.6.0

Пример

expect(mySpy).toHaveBeenCalledOnceWith('foo', 'bar', 2);

toHaveBeenCalledTimes(expected)

expect фактическое значение (шпион) было вызвано указанное количество раз.

Параметры:

Имя	Тип	Описание
`expected`	Число	Количество вызовов для поиска.

С момента:

2.4.0

Пример

expect(mySpy).toHaveBeenCalledTimes(3);

toHaveBeenCalledWith()

expect фактическое значение (шпион) было вызвано с определенными аргументами хотя бы один раз.

Параметры:

Тип	Атрибуты	Описание
Объект	<repeatable>	Искомые аргументы

С момента:

1.3.0

Пример

expect(mySpy).toHaveBeenCalledWith('foo', 'bar', 2);

toHaveClass(expected)

expect фактическое значение является элементом DOM, у которого есть ожидаемый класс.

Параметры:

Имя	Тип	Описание
`expected`	Объект	Имя класса для проверки

С момента:

3.0.0

Пример

var el = document.createElement('div');
el.className = 'foo bar baz';
expect(el).toHaveClass('bar');

toHaveSize(expected)

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

Параметры:

Имя	Тип	Описание
`expected`	Объект	Ожидаемый размер

С момента:

3.6.0

Пример

array = [1,2];
expect(array).toHaveSize(2);

toMatch(expected)

expect фактическое значение для соответствия регулярному выражению

Параметры:

Имя	Тип	Описание
`expected`	RegExp \| String	Значение для поиска в строке.

С тех пор:

1.3.0

Пример

expect("my string").toMatch(/string$/);
expect("other string").toMatch("her");

toThrow(expectedopt)

expect функцию для throw чего-то.

Параметры:

Имя	Тип	Атрибуты	Описание
`expected`	Object	<необязательно>	Значение, которое должно быть выброшено. Если не указано, просто то, что что-то было выброшено, будет проверено.

С тех пор:

2.0.0

Пример

expect(function() { return 'things'; }).toThrow('foo');
expect(function() { return 'stuff'; }).toThrow();

toThrowError(expectedopt, messageopt)

expect функцию для throw исключения Error.

Параметры:

Имя	Тип	Атрибуты	Описание
`expected`	Error	<необязательно>	Конструктор объекта, который нужно выбросить. Если не указано, будет использоваться `Error`.
`message`	RegExp \| String	<необязательно>	Сообщение, которое должно быть установлено на выброшенном `Error`

С тех пор:

2.0.0

Пример

expect(function() { return 'things'; }).toThrowError(MyCustomError, 'message');
expect(function() { return 'things'; }).toThrowError(MyCustomError, /bar/);
expect(function() { return 'stuff'; }).toThrowError(MyCustomError);
expect(function() { return 'other'; }).toThrowError(/foo/);
expect(function() { return 'other'; }).toThrowError();

toThrowMatching(predicate)

expect функцию для throw чего-то, соответствующего предикату.

Параметры:

Имя	Тип	Описание
`predicate`	function	Функция, которая принимает выброшенное исключение в качестве параметра и возвращает true, если оно соответствует.

С тех пор:

3.0.0

Пример

expect(function() { throw new Error('nope'); }).toThrowMatching(function(thrown) { return thrown.message === 'nope'; });

withContext(message) → {matchers}

Добавить контекст для expect

Параметры:

Имя	Тип	Описание
`message`	String	Дополнительный контекст, который нужно отобразить при сбое матчера

С тех пор:

3.3.0

Возвращает:

Тип: matchers