Что такое «Stub-объект»
Код редко живёт сам по себе: он запрашивает API, читает базу, проверяет текущую дату. В модульном тесте всё это мешает — тест становится медленным, зависит от сети и даёт разный результат в разные дни. Заглушка подставляется вместо такой зависимости и отвечает всегда одинаково, поэтому тест проверяет только логику самого кода.
Классификацию подставных объектов — dummy, stub, spy, mock, fake — популяризировал Джерард Месарош в книге «xUnit Test Patterns», а Мартин Фаулер разобрал разницу между заглушками и моками в статье «Mocks Aren’t Stubs». В обиходе слова часто путают, и библиотеки тоже не всегда следуют этим названиям.
Пример заглушки
// функция, которую тестируем
async function cartTotal(api, cartId) {
const items = await api.getItems(cartId);
return items.reduce((sum, i) => sum + i.price * i.qty, 0);
}
// заглушка вместо настоящего API
const apiStub = {
getItems: async () => [{ price: 100, qty: 2 }, { price: 50, qty: 1 }],
};
console.assert(await cartTotal(apiStub, 'any') === 250);
Заглушке не важно, какой cartId пришёл: она отдаёт фиксированную корзину. Тест проверяет расчёт суммы, а не работу сервера. Тот же приём позволяет смоделировать редкие случаи — пустую корзину или ответ с ошибкой, — которые сложно получить от живого API.
Заглушка или мок
Заглушка отвечает на вопрос «что вернуть». Mock-объект отвечает ещё и на вопрос «как с ним обращались»: тест проверяет, что метод вызвали нужное число раз и с правильными аргументами. Если важен только результат функции — хватает заглушки. Если важно само взаимодействие, например что письмо действительно отправлено, нужен мок или шпион.
Когда заглушки вредят
Заглушка фиксирует представление о том, как отвечает зависимость. Если реальный API изменил формат, тесты с заглушками продолжат проходить, хотя сайт уже сломан. Поэтому модульные тесты на заглушках дополняют интеграционными, которые хотя бы изредка обращаются к настоящему сервису или его тестовому стенду.
Связанные термины
Обновлено: 10 октября 2026

