Мы убрали any из кодовой базы. Стало не лучше
В начале лета мы включили noImplicitAny, потом strict, потом запретили явный any правилом линтера. Через два месяца я готов сформулировать, что мы получили на самом деле.
Что мы ожидали
Что типы поймают ошибки, которые раньше ловил продакшен. Что рефакторинг станет безопаснее. Что новичкам будет проще — редактор подскажет.
Первое и третье оказалось правдой. Второе — с оговорками.
Что произошло на самом деле
Замены any разделились на три категории, и только одна была полезной.
1. Настоящие ошибки
Где-то действительно приходило не то, что ожидалось: null вместо массива, строка вместо числа из JSON. Такие места после включения строгости стали падать в тестах, а не у пользователей. Это была хорошая часть.
2. Косметика
Где-то мы просто написали as SomeType, чтобы линтер замолчал. По сути то же самое any, только с более уверенным видом. Строгий режим не мешает врать — он мешает врать неявно.
3. Бойлерплейт, который скрыл проблему
Вот это было неприятно. Вместо одного any появились три интерфейса, дженерик и функция-гард — на месте, где данные приходят из внешнего API и никто не знает их формы. Типы стали строгими и при этом неверными: они описывали нашу веру в формат ответа, а не сам ответ.
Главный вывод
any был не причиной, а симптомом: он стоял там, где граница системы — сеть, файл, localStorage, сообщение из очереди. Убирать надо не any, а бесконтрольность на границе.
Рабочая схема оказалась такой:
- на входе (fetch, очередь, форма) данные имеют тип
unknown; - сразу за границей — валидация схемой (у нас zod), которая либо возвращает типизированный объект, либо ошибку;
- внутри домена — обычные типы, без
unknownи безas; anyзапрещён, но разрешёнunknownи явное приведение после проверки.
Как это выглядело в коде
// было
const data: any = await res.json();
render(data.items);
// стало
const raw: unknown = await res.json();
const parsed = PayloadSchema.safeParse(raw);
if (!parsed.success) {
logger.warn('bad payload', parsed.error.issues);
return renderEmpty();
}
render(parsed.data.items);
Строк стало больше, но ошибки теперь видно в одном месте — на границе, с логом и понятным поведением. Раньше они всплывали в рендере, через три вызова, с сообщением Cannot read properties of undefined.
Что бы я сделал иначе
- Начал бы с границ, а не с линтера. Сначала схемы на входе, потом
strict. - Не включал бы правило «запрещён любой
any» без исключений: иногдаany— честная пометка «здесь мы не знаем», и это лучше, чем ложная строгость. - Посчитал бы стоимость заранее. У нас ушло примерно 40 человеко-часов на замену, из которых полезными были, наверное, половина.
Строгость типов — это инструмент, а не цель. Она окупается там, где данные пересекают границу, и почти не окупается там, где вы просто перекладываете объект из функции в функцию.