Переспецифицированный тест.

Переспецифицированный тест узнаётся по тому, что его ломает: безобидный рефакторинг или случайное изменение приводит к падению тестов, хотя описываемое ими поведение по-прежнему корректно.

Типичные признаки:

• Проверки несущественных деталей. Точные пробелы/разметка, полные строки сообщений об ошибках, текст логов, форматирование или изменчивые значения вроде временных меток, UUID и автоинкрементных идентификаторов.
• Сравнение объекта целиком там, где важно одно поле. toEqual({...весь объект...}), когда тест на самом деле об одном-единственном свойстве.
• Чувствительные к порядку проверки на логически неупорядоченных данных. Фиксация порядка множества, ключей отображения (map) или результатов запроса, который контракт не гарантирует.
• Проверка поведения внутренних сотрудников-зависимостей. Моки, проверяющие точное число вызовов, значения аргумент за аргументом и порядок вызовов внутренних зависимостей вместо наблюдаемого конечного результата.
• Гигантские снимки (snapshots), захватывающие всё отрендеренное дерево или тело ответа, так что любое вложенное изменение вынуждает перезаписывать снимок.
• Чрезмерно точные матчеры. toStrictEqual там, где хватило бы toMatchObject; точное равенство чисел с плавающей точкой вместо toBeCloseTo; полный текст сообщения там, где требование выражает ключевая фраза (toThrow(/expired/)).

// Переспецифицировано: фиксирует точную разметку, изменчивую временную метку и каждый вызов сотрудника
test('renders user badge', () => {
  const html = renderBadge(user);
  expect(html).toBe('<span class="badge badge--admin">Ada Lovelace</span>'); // точная разметка
  expect(analytics.track).toHaveBeenCalledTimes(1);                          // внутренний счётчик вызовов
  expect(analytics.track).toHaveBeenCalledWith('badge_render', { ts: 1718445693221 }); // изменчивое
});

Полезная лакмусовая проверка: если можно изменить реализацию, не меняя задокументированное поведение, а тест всё равно падает — он переспецифицирован.

Соседние запахи: проверки структуры DOM или приватного состояния вместо того, что видит пользователь или вызывающий код, — это «Тестирование деталей реализации»; тест, утонувший в настройке моков, — «Чрезмерное использование моков». Переспецифицированный тест — это проверка большего, чем требует поведение, даже если все проверки идут через публичный API.

Почему это происходит

• Установка «больше проверок = тщательнее»: разработчики фиксируют всё, что видят, путая полноту с корректностью.
• Инструментарий делает переспецификацию путём наименьшего сопротивления: toMatchSnapshot() записывает весь вывод целиком, а фреймворки моков делают тривиальной проверку каждого взаимодействия (toHaveBeenCalledWith, порядок вызовов, их количество).
• Копирование реального литерала объекта в toEqual вместо проверки только того поля, о котором этот тест.
• Обилие моков: когда каждый коллаборатор подменён моком («Чрезмерное использование моков»), проверить каждый из них кажется естественным завершением теста.

Почему это вредно

В книге Джерарда Месароса xUnit Test Patterns это коренная причина запаха Fragile Test (хрупкий тест), приписываемая Overspecified Software и Behavior Sensitivity: тесты связаны с тем, как работает код, а не с тем, что он производит, поэтому они падают при изменениях, не влияющих на поведение.

• Сопровождаемость. Каждый рефакторинг вызывает каскад несвязанных падений тестов, из-за чего держать набор «зелёным» дорого, и это активно отбивает желание рефакторить.
• Надёжность / доверие. Тесты, которые «кричат „волки!“» на корректном коде, приучают команду игнорировать падения или вслепую перезаписывать их (особенно со снимками-снапшотами).
• Ложная уверенность. Переспецификация часто соседствует с недостаточной проверкой значимого результата: тест может зафиксировать временную метку и строку лога, но так и не проверить значение, которое на самом деле важно пользователю. Как формулирует литература по тестированию взаимодействий, переспецификация — это «проверка того, что не является частью конечного результата», чаще всего через проверку взаимодействий вместо результатов.
• Читаемость. Стена побочных проверок скрывает то единственное поведение, которое тест призван документировать.

Проверяйте только то, что требует проверяемое поведение, — и предпочитайте проверку конечного результата внутренним взаимодействиям.

1. Назовите тот единственный результат, который документирует тест, и проверяйте именно его и ничего больше. По-настоящему различные результаты разнесите по отдельным, хорошо названным тестам, а не в одну мега-проверку.
2. Используйте частичные/нестрогие матчеры вместо точного сравнения объекта целиком: expect.objectContaining, toMatchObject, arrayContaining, stringContaining/stringMatching и expect.any(...) для полей, которые нельзя или не следует фиксировать.
3. Нейтрализуйте изменчивые данные (временные метки, идентификаторы, случайные значения) матчерами свойств (expect.any(String)) или путём внедрения фиксированных часов/генератора идентификаторов — не «зашивайте» сегодняшнее значение.
4. Откажитесь от предположений о порядке для неупорядоченных данных: проверяйте принадлежность (arrayContaining) или сортируйте перед сравнением.
5. Предпочитайте проверку состояния проверке поведения. Подменяйте заглушками запросы (не проверяйте их); проверяйте вызов сотрудника-зависимости лишь тогда, когда этот вызов и есть наблюдаемый побочный эффект (команда), и избегайте проверки точного числа/порядка чисто внутренних вызовов.
6. Держите снимки маленькими и осмысленными или замените раскидистый снимок несколькими прицельными проверками тех фактов, которые тест должен защищать. (Доступ к DOM через container или к приватному состоянию — отдельный запах, см. «Тестирование деталей реализации».)

До → после:

// До: привязывает тест к изменчивым полям и последовательности внутренних вызовов
expect(result).toEqual({
  id: '8f3c-92a1-...',                  // случайный uuid
  createdAt: '2026-06-15T10:01:33.221Z',// Date.now()
  name: 'Ada Lovelace',
  role: 'admin',
});
expect(logger.info).toHaveBeenCalledTimes(3);
expect(db.connect).toHaveBeenCalledBefore(db.query);

// После: проверяем только то поведение, о котором этот тест
expect(result).toMatchObject({ name: 'Ada Lovelace', role: 'admin' });
// id/createdAt побочны; логирование и порядок вызовов — детали реализации, не фиксируйте их

toHaveBeenCalledBefore — не встроенный матчер Jest: он берётся из библиотеки jest-extended (в Vitest он встроен начиная с версии 3.0). В любом раннере фиксируйте порядок вызовов, только если сам порядок и есть требование.