Что такое «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

Все термины раздела «Frontend» ↗