Вызов шпиона

Вызов шпиона

Вызов шпиона — это объектное представление отдельного вызова функции «шпион», которая может быть фейком, шпионом, стабом или методом-мока.

var spyCall = spy.getCall(n)

Возвращает n-й вызов. Доступ к отдельным вызовам помогает в более детальной проверке поведения, когда шпион вызывается более одного раза.

sinon.spy(jQuery, "ajax");
jQuery.ajax("/stuffs");
var spyCall = jQuery.ajax.getCall(0);

assertEquals("/stuffs", spyCall.args[0]);

spyCall.calledOn(obj);

Возвращает true если obj был this для этого вызова. calledOn также принимает матчер spyCall.calledOn(sinon.match(fn)) (см. мачеры).

spyCall.calledWith(arg1, arg2, ...);

Возвращает true если вызов получил указанные аргументы (и, возможно, другие).

spyCall.calledWithExactly(arg1, arg2, ...);

Возвращает true если вызов получил указанные аргументы и больше никаких.

spyCall.calledWithMatch(arg1, arg2, ...);

Возвращает true если вызов получил соответствующие аргументы (и, возможно, другие). Это ведет себя так же, как spyCall.calledWith(sinon.match(arg1), sinon.match(arg2), ...).

spyCall.notCalledWith(arg1, arg2, ...);

Возвращает true если вызов не получил указанные аргументы.

spyCall.notCalledWithMatch(arg1, arg2, ...);

Возвращает true если вызов не получил соответствующие аргументы. Это ведет себя так же, как spyCall.notCalledWith(sinon.match(arg1), sinon.match(arg2), ...).

spyCall.returned(value);

Возвращает true если шпионируемая функция вернула указанное value в этом вызове.

Используется глубокое сравнение для объектов и массивов. Используйте spyCall.returned(sinon.match.same(obj)) для строгого сравнения (см. мачеры).

spyCall.threw();

Возвращает true если вызов бросил исключение.

spyCall.threw("TypeError");

Возвращает true если вызов бросил исключение указанного типа.

spyCall.threw(obj);

Возвращает true если вызов бросил указанный объект исключения.

spyCall.calledBefore(otherCall)

Возвращает true если вызов шпиона произошёл до другого вызова шпиона.

spyCall.calledAfter(otherCall)

Возвращает true если вызов шпиона произошёл после другого вызова шпиона.

spyCall.calledImmediatelyBefore(otherCall)

Возвращает true если вызов шпиона произошёл перед другим вызовом, и между ними не было других вызовов других шпионов.

spyCall.calledImmediatelyAfter(otherCall)

Возвращает true если вызов шпиона произошёл после другого вызова, и между ними не было других вызовов других шпионов.

spyCall.thisValue

Значение this вызова.

spyCall.args

Массив полученных аргументов.

spyCall.callback

Это свойство — удобный способ получить коллбек вызова.

Когда последний аргумент в вызове является Function, тогда callback будет ссылаться на него. В противном случае он будет undefined.

var spy = sinon.spy();
var callback = function () {};

spy(1, 2, 3, callback);

spy.lastCall.callback === callback;
// true

spyCall.lastArg

Это свойство — удобный способ получить последний аргумент вызова.

var spy = sinon.spy();
var date = new Date();

spy(1, 2, date);

spy.lastCall.lastArg === date;
// true

spyCall.exception

Брошенное исключение, если таковое имеется.

spyCall.returnValue

Возвращаемое значение.