|
|
@@ -13,8 +13,6 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
it('should throw when trying to spy on null', function () {
|
|
|
- // проверка генерации ошибки при попытке
|
|
|
- // шпионить за значением null
|
|
|
expect(() => createSpy(null)).to.throw(
|
|
|
TypeError,
|
|
|
'Attempted to spy on null.',
|
|
|
@@ -22,15 +20,11 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
it('should throw if target is not a function and no method name is given', function () {
|
|
|
- // проверка генерации ошибки для не-функции
|
|
|
- // без указания имени метода
|
|
|
- // @ts-ignore
|
|
|
expect(() => createSpy({})).to.throw(
|
|
|
TypeError,
|
|
|
'Attempted to spy on a non-function value. To spy on an object method, ' +
|
|
|
'you must provide the method name as the second argument.',
|
|
|
);
|
|
|
- // @ts-ignore
|
|
|
expect(() => createSpy(123)).to.throw(
|
|
|
TypeError,
|
|
|
'Attempted to spy on a non-function value. To spy on an object method, ' +
|
|
|
@@ -39,10 +33,7 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
it('should throw if custom implementation for a function spy is not a function', function () {
|
|
|
- // проверка генерации ошибки, если кастомная
|
|
|
- // реализация для шпиона функции не является функцией
|
|
|
const targetFn = () => {};
|
|
|
- // @ts-ignore
|
|
|
expect(() => createSpy(targetFn, 'not a function')).to.throw(
|
|
|
TypeError,
|
|
|
'When spying on a function, the second argument (custom implementation) must be a function if provided.',
|
|
|
@@ -50,10 +41,7 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
it('should throw if trying to spy on a non-existent method', function () {
|
|
|
- // проверка генерации ошибки при попытке
|
|
|
- // шпионить за несуществующим методом объекта
|
|
|
const obj = {};
|
|
|
- // @ts-ignore
|
|
|
expect(() => createSpy(obj, 'nonExistentMethod')).to.throw(
|
|
|
TypeError,
|
|
|
'Attempted to spy on a non-existent property: "nonExistentMethod"',
|
|
|
@@ -61,10 +49,7 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
it('should throw if trying to spy on a non-function property of an object', function () {
|
|
|
- // проверка генерации ошибки при попытке
|
|
|
- // шпионить за свойством объекта, не являющимся функцией
|
|
|
const obj = {prop: 123};
|
|
|
- // @ts-ignore
|
|
|
expect(() => createSpy(obj, 'prop')).to.throw(
|
|
|
TypeError,
|
|
|
'Attempted to spy on "prop" which is not a function. It is a "number".',
|
|
|
@@ -72,10 +57,7 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
it('should throw if custom implementation for a method spy is not a function', function () {
|
|
|
- // проверка генерации ошибки, если кастомная реализация
|
|
|
- // для шпиона метода не является функцией
|
|
|
const obj = {method: () => {}};
|
|
|
- // @ts-ignore
|
|
|
expect(() => createSpy(obj, 'method', 'not a function')).to.throw(
|
|
|
TypeError,
|
|
|
'When spying on a method, the third argument (custom implementation) must be a function if provided.',
|
|
|
@@ -85,110 +67,65 @@ describe('createSpy', function () {
|
|
|
|
|
|
describe('when spying on a standalone function', function () {
|
|
|
it('should return a function that is the spy', function () {
|
|
|
- // создание шпиона для пустой функции
|
|
|
const targetFn = () => {};
|
|
|
const spy = createSpy(targetFn);
|
|
|
- // проверка того, что шпион
|
|
|
- // является функцией
|
|
|
expect(spy).to.be.a('function');
|
|
|
});
|
|
|
|
|
|
it('should not be called initially', function () {
|
|
|
- // создание шпиона
|
|
|
const spy = createSpy(function () {});
|
|
|
- // первоначальное состояние свойства called
|
|
|
expect(spy.called).to.be.false;
|
|
|
- // первоначальное значение счетчика вызовов
|
|
|
expect(spy.callCount).to.be.eq(0);
|
|
|
});
|
|
|
|
|
|
it('should track calls and arguments', function () {
|
|
|
- // создание шпиона для функции,
|
|
|
- // возвращающей сумму аргументов
|
|
|
const sum = (a, b) => a + b;
|
|
|
const spy = createSpy(sum);
|
|
|
- // первый вызов шпиона
|
|
|
spy(1, 2);
|
|
|
- // второй вызов шпиона
|
|
|
spy(3, 4);
|
|
|
-
|
|
|
- // состояние свойства called
|
|
|
- // после вызовов
|
|
|
expect(spy.called).to.be.true;
|
|
|
- // значение счетчика вызовов
|
|
|
expect(spy.callCount).to.be.eq(2);
|
|
|
-
|
|
|
- // проверка аргументов первого вызова
|
|
|
expect(spy.calls[0].args).to.deep.equal([1, 2]);
|
|
|
- // проверка аргументов второго вызова
|
|
|
expect(spy.calls[1].args).to.deep.equal([3, 4]);
|
|
|
});
|
|
|
|
|
|
it('should call the original function and return its value by default', function () {
|
|
|
- // создание функции, возвращающей
|
|
|
- // определенное значение
|
|
|
const originalFn = () => 'original value';
|
|
|
const spy = createSpy(originalFn);
|
|
|
- // вызов шпиона и сохранение результата
|
|
|
const result = spy();
|
|
|
-
|
|
|
- // проверка возвращенного значения
|
|
|
expect(result).to.be.eq('original value');
|
|
|
- // проверка того, что шпион был вызван
|
|
|
expect(spy.called).to.be.true;
|
|
|
});
|
|
|
|
|
|
it('should use the custom implementation if provided', function () {
|
|
|
- // создание оригинальной функции и
|
|
|
- // пользовательской реализации
|
|
|
const originalFn = () => 'original';
|
|
|
const customImpl = () => 'custom';
|
|
|
const spy = createSpy(originalFn, customImpl);
|
|
|
- // вызов шпиона и сохранение результата
|
|
|
const result = spy();
|
|
|
-
|
|
|
- // проверка того, что возвращено значение
|
|
|
- // из пользовательской реализации
|
|
|
expect(result).to.be.eq('custom');
|
|
|
- // проверка свойства called
|
|
|
expect(spy.called).to.be.true;
|
|
|
});
|
|
|
|
|
|
it('should preserve `this` context for the original function', function () {
|
|
|
- // определение объекта с методом, который
|
|
|
- // будет использоваться как target функция
|
|
|
const contextObj = {val: 10};
|
|
|
function originalFn() {
|
|
|
return this.val;
|
|
|
}
|
|
|
const spy = createSpy(originalFn);
|
|
|
- // вызов шпиона с привязкой контекста
|
|
|
const result = spy.call(contextObj);
|
|
|
-
|
|
|
- // проверка возвращенного значения, которое
|
|
|
- // зависит от контекста this
|
|
|
expect(result).to.be.eq(10);
|
|
|
- // проверка сохраненного контекста
|
|
|
- // в информации о вызове
|
|
|
expect(spy.calls[0].thisArg).to.be.eq(contextObj);
|
|
|
});
|
|
|
|
|
|
it('should preserve `this` context for the custom implementation', function () {
|
|
|
- // определение объекта и пользовательской реализации,
|
|
|
- // использующей контекст this
|
|
|
const contextObj = {val: 20};
|
|
|
const originalFn = () => {};
|
|
|
function customImpl() {
|
|
|
return this.val;
|
|
|
}
|
|
|
const spy = createSpy(originalFn, customImpl);
|
|
|
- // вызов шпиона с привязкой контекста
|
|
|
const result = spy.call(contextObj);
|
|
|
-
|
|
|
- // проверка возвращенного значения из
|
|
|
- // пользовательской реализации
|
|
|
expect(result).to.be.eq(20);
|
|
|
- // проверка сохраненного контекста
|
|
|
expect(spy.calls[0].thisArg).to.be.eq(contextObj);
|
|
|
});
|
|
|
|
|
|
@@ -196,15 +133,10 @@ describe('createSpy', function () {
|
|
|
it('should reset its history and not throw', function () {
|
|
|
const standaloneFn = () => 'standalone result';
|
|
|
const fnSpy = createSpy(standaloneFn);
|
|
|
- // вызов шпиона, чтобы у него была история
|
|
|
- // @ts-ignore
|
|
|
fnSpy('call standalone');
|
|
|
expect(fnSpy.called).to.be.true;
|
|
|
expect(fnSpy.callCount).to.be.eq(1);
|
|
|
- expect(fnSpy.calls[0].args).to.deep.equal(['call standalone']);
|
|
|
- // проверка, что вызов restore не вызывает ошибок
|
|
|
expect(() => fnSpy.restore()).to.not.throw();
|
|
|
- // проверки сброса истории
|
|
|
expect(fnSpy.callCount).to.be.eq(0);
|
|
|
expect(fnSpy.called).to.be.false;
|
|
|
});
|
|
|
@@ -212,90 +144,61 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
describe('when spying on an object method', function () {
|
|
|
- // определение объекта и его метода
|
|
|
- // для каждого теста в этом блоке
|
|
|
- let obj;
|
|
|
- let originalMethodImpl; // для проверки восстановления
|
|
|
-
|
|
|
- beforeEach(function () {
|
|
|
- // это функция, которая будет телом
|
|
|
- // beforeEach, поэтому комментарии здесь уместны
|
|
|
- // инициализация объекта с методом
|
|
|
- // перед каждым тестом
|
|
|
- originalMethodImpl = function (val) {
|
|
|
- return `original: ${this.name} ${val}`;
|
|
|
- };
|
|
|
- obj = {
|
|
|
- name: 'TestObj',
|
|
|
- method: originalMethodImpl,
|
|
|
- };
|
|
|
- });
|
|
|
-
|
|
|
it('should replace the original method with the spy', function () {
|
|
|
- // создание шпиона для метода объекта
|
|
|
+ const obj = {method: () => {}};
|
|
|
const spy = createSpy(obj, 'method');
|
|
|
- // проверка того, что свойство объекта
|
|
|
- // теперь является шпионом
|
|
|
expect(obj.method).to.be.eq(spy);
|
|
|
- // проверка того, что шпион является функцией
|
|
|
expect(obj.method).to.be.a('function');
|
|
|
});
|
|
|
|
|
|
it('should call the original method with object context and return its value', function () {
|
|
|
- // создание шпиона для метода
|
|
|
+ const originalMethodImpl = function (val) {
|
|
|
+ return `original: ${this.name} ${val}`;
|
|
|
+ };
|
|
|
+ const obj = {
|
|
|
+ name: 'TestObj',
|
|
|
+ method: originalMethodImpl,
|
|
|
+ };
|
|
|
const spy = createSpy(obj, 'method');
|
|
|
- // вызов подмененного метода
|
|
|
const result = obj.method('arg1');
|
|
|
-
|
|
|
- // проверка возвращенного значения
|
|
|
- // от оригинального метода
|
|
|
expect(result).to.be.eq('original: TestObj arg1');
|
|
|
- // проверка счетчика вызовов
|
|
|
expect(spy.callCount).to.be.eq(1);
|
|
|
- // проверка сохраненного контекста
|
|
|
expect(spy.calls[0].thisArg).to.be.eq(obj);
|
|
|
- // проверка сохраненных аргументов
|
|
|
expect(spy.calls[0].args).to.deep.equal(['arg1']);
|
|
|
});
|
|
|
|
|
|
it('should use custom implementation with object context if provided', function () {
|
|
|
- // определение пользовательской реализации
|
|
|
+ const obj = {
|
|
|
+ name: 'TestObj',
|
|
|
+ method: () => {},
|
|
|
+ };
|
|
|
const customImpl = function (val) {
|
|
|
return `custom: ${this.name} ${val}`;
|
|
|
};
|
|
|
- // создание шпиона с пользовательской реализацией
|
|
|
const spy = createSpy(obj, 'method', customImpl);
|
|
|
- // вызов подмененного метода
|
|
|
const result = obj.method('argCustom');
|
|
|
-
|
|
|
- // проверка возвращенного значения
|
|
|
- // от пользовательской реализации
|
|
|
expect(result).to.be.eq('custom: TestObj argCustom');
|
|
|
- // проверка счетчика вызовов
|
|
|
expect(spy.callCount).to.be.eq(1);
|
|
|
- // проверка сохраненного контекста
|
|
|
expect(spy.calls[0].thisArg).to.be.eq(obj);
|
|
|
});
|
|
|
|
|
|
describe('.restore()', function () {
|
|
|
it('should put the original method back and reset spy history', function () {
|
|
|
- // создание шпиона для метода
|
|
|
+ const originalMethodImpl = function (val) {
|
|
|
+ return `original: ${this.name} ${val}`;
|
|
|
+ };
|
|
|
+ const obj = {
|
|
|
+ name: 'TestObj',
|
|
|
+ method: originalMethodImpl,
|
|
|
+ };
|
|
|
const spy = createSpy(obj, 'method');
|
|
|
- // вызов шпиона, чтобы у него была история
|
|
|
obj.method('call before restore');
|
|
|
expect(spy.called).to.be.true;
|
|
|
- expect(spy.callCount).to.be.eq(1);
|
|
|
expect(obj.method).to.be.eq(spy);
|
|
|
- // вызов метода restore на шпионе
|
|
|
spy.restore();
|
|
|
- // проверка, что оригинальный метод восстановлен
|
|
|
expect(obj.method).to.be.eq(originalMethodImpl);
|
|
|
- // вызов восстановленного метода
|
|
|
- // для проверки его работоспособности
|
|
|
const result = obj.method('call after restore');
|
|
|
- // проверка результата вызова оригинального метода
|
|
|
expect(result).to.be.eq('original: TestObj call after restore');
|
|
|
- // проверки сброса истории
|
|
|
expect(spy.callCount).to.be.eq(0);
|
|
|
expect(spy.called).to.be.false;
|
|
|
});
|
|
|
@@ -306,7 +209,6 @@ describe('createSpy', function () {
|
|
|
return 'own';
|
|
|
},
|
|
|
};
|
|
|
- expect(Object.prototype.hasOwnProperty.call(obj, 'fn')).to.be.true;
|
|
|
const spy = createSpy(obj, 'fn');
|
|
|
expect(obj.fn).to.be.eq(spy);
|
|
|
spy.restore();
|
|
|
@@ -323,7 +225,6 @@ describe('createSpy', function () {
|
|
|
const instance = new Base();
|
|
|
expect(Object.prototype.hasOwnProperty.call(instance, 'method')).to.be
|
|
|
.false;
|
|
|
- expect(instance.method()).to.be.eq('prototype');
|
|
|
const spy = createSpy(instance, 'method');
|
|
|
expect(Object.prototype.hasOwnProperty.call(instance, 'method')).to.be
|
|
|
.true;
|
|
|
@@ -337,29 +238,15 @@ describe('createSpy', function () {
|
|
|
});
|
|
|
|
|
|
describe('spy properties and methods', function () {
|
|
|
- // объявление шпиона для использования в тестах
|
|
|
- let spy;
|
|
|
- // определение функции, которая
|
|
|
- // будет объектом шпионажа
|
|
|
- const targetFn = (a, b) => {
|
|
|
- if (a === 0) throw new Error('zero error');
|
|
|
- return a + b;
|
|
|
- };
|
|
|
-
|
|
|
- beforeEach(function () {
|
|
|
- // это функция, которая будет телом
|
|
|
- // beforeEach, поэтому комментарии здесь уместны
|
|
|
- // создание нового шпиона перед
|
|
|
- // каждым тестом в этом блоке
|
|
|
- spy = createSpy(targetFn);
|
|
|
- });
|
|
|
-
|
|
|
it('should have the __isSpy property with true value', function () {
|
|
|
+ const spy = createSpy(() => {});
|
|
|
expect(spy['__isSpy']).to.be.true;
|
|
|
});
|
|
|
|
|
|
describe('.calls', function () {
|
|
|
it('should return an array of CallInfo', function () {
|
|
|
+ const targetFn = (a, b) => a + b;
|
|
|
+ const spy = createSpy(targetFn);
|
|
|
expect(spy.calls).to.be.eql([]);
|
|
|
spy(1, 2);
|
|
|
expect(spy.calls[0]).to.be.eql({
|
|
|
@@ -381,21 +268,17 @@ describe('createSpy', function () {
|
|
|
|
|
|
describe('.callCount and .called', function () {
|
|
|
it('should have callCount = 0 and called = false initially', function () {
|
|
|
- // начальное состояние счетчика вызовов
|
|
|
+ const spy = createSpy(() => {});
|
|
|
expect(spy.callCount).to.be.eq(0);
|
|
|
- // начальное состояние флага called
|
|
|
expect(spy.called).to.be.false;
|
|
|
});
|
|
|
|
|
|
it('should update after calls', function () {
|
|
|
- // первый вызов шпиона
|
|
|
+ const spy = createSpy(() => {});
|
|
|
spy(1, 1);
|
|
|
- // состояние после первого вызова
|
|
|
expect(spy.callCount).to.be.eq(1);
|
|
|
expect(spy.called).to.be.true;
|
|
|
- // второй вызов шпиона
|
|
|
spy(2, 2);
|
|
|
- // состояние после второго вызова
|
|
|
expect(spy.callCount).to.be.eq(2);
|
|
|
});
|
|
|
});
|
