Швы

Шов — это место, где можно изменить поведение, не редактируя его прямо там. Это определение (из книги Физерса Working Effectively with Legacy Code) точное и держать его стоит дословно. Смысл шва — не «хороший дизайн» в абстракции, а рычаг: точка, где ты, тестировщик, можешь подставить другое поведение во время выполнения, не трогая строки, которые делают работу. У каждого шва есть точка включения — место, где решается, какое поведение активно (аргумент конструктора, параметр, флаг сборки).

У вшитого кода швов нет. Когда функция буквально содержит new Date() или Database.query(...), нет места, чтобы встать снаружи и сказать «используй вместо этого вот это». Вся игра в том, чтобы обложить легаси тестами, сводится к: найти или создать шов, затем им воспользоваться.

Самый частый шов — объектный: внедри коллаборатора вместо того, чтобы конструировать его. Возьмём юнит, приваренный к часам:

// нет шва — поведение приварено к реальным часам
function isTrialExpired(user: User): boolean {
  const now = new Date();              // ← нельзя подменить из теста
  return now.getTime() > user.trialEndsAt.getTime();
}

Нельзя детерминированно протестировать «истёк» против «активен»: ответ зависит от настенных часов. Вводим объектный шов, передавая зависимость внутрь:

interface Clock { now(): Date }
const systemClock: Clock = { now: () => new Date() };

function isTrialExpired(user: User, clock: Clock = systemClock): boolean {
  return clock.now().getTime() > user.trialEndsAt.getTime();
}

Шов — это параметр clock; точка включения — место вызова (прод не передаёт ничего и получает systemClock; тест передаёт { now: () => new Date('2026-01-01') }). Заметь, что значение по умолчанию оставляет всех существующих вызывающих нетронутыми — изменение аддитивно, а не переписывание. Это ровно внедрение зависимостей, но DI — лишь один вид шва.

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

• Объектный шов — подмени коллаборатора (Clock/Repository выше). Точка включения: конструктор или параметр. Лучший дефолт в TS.
• Параметрический шов — передай само меняющееся значение, а не целый объект: isTrialExpired(user, now: Date). Ещё меньше, чем внедрять Clock, когда тебе нужно лишь одно показание.
• Шов «подкласс и переопределение» — оберни вшитый вызов в protected-метод, затем переопредели его в тестовом подклассе. Полезно, когда нельзя менять сигнатуру (это хук фреймворка или слишком много вызывающих).
• Линковочный/языковой шов — подмени на этапе разрешения модулей или сборки (тестовый дублёр для импортируемого модуля, например мок ./db в тестовом раннере). Точка включения целиком вне исходного кода.

Senior-ход — тянуться к наименее инвазивному шву, разблокирующему тест, а не к самому архитектурно чистому. Параметрический шов, который ты добавишь за тридцать секунд, бьёт иерархию интерфейсов, на которую ты потратишь день.

Тот же приём укрощает глобалы и прямой ввод-вывод — шов там, где юнит тянется наружу. Глобальный синглтон конфига и прямой db.query — та же проблема, что и new Date(): юнит называет конкретную вещь из реального мира вместо того, чтобы принимать абстракцию.

// нет шва — читает глобал и бьёт по реальной БД
async function chargeOverdue(): Promise<number> {
  const limit = GlobalConfig.get('overdueLimit');   // глобал
  const rows = await db.query('SELECT * FROM invoices WHERE overdue = true'); // реальная БД
  return rows.filter((r) => r.amount > limit).length;
}

// швы: конфиг и репозиторий передаются внутрь
interface InvoiceRepo { listOverdue(): Promise<Invoice[]> }

async function chargeOverdue(repo: InvoiceRepo, limit: number): Promise<number> {
  const rows = await repo.listOverdue();
  return rows.filter((r) => r.amount > limit).length;
}

Теперь тест передаёт repo, возвращающий три фиксированных счёта, и limit, и проверяет счётчик — никакой базы, никакого глобала. Логика функции (фильтр и подсчёт) всегда была интересной частью; швы просто дали к ней дотянуться. Заметь, мы не «проектировали слой персистентности» — мы вынесли ровно те две зависимости, что нужны тесту, и остановились.