re:re:actable
Урок 092 минуты чтения

Runtime ошибки и TypeScript

На этой странице
Кратко

TypeScript уменьшает количество ошибок, но не устраняет runtime-ошибки: после компиляции выполняется обычный JavaScript.

Вопрос

Может ли TypeScript полностью защитить от ошибок во время выполнения?

Короткий ответ

Нет. TypeScript проверяет типы до запуска, но не гарантирует, что во время выполнения данные будут корректными, сеть не упадет, DOM-элемент найдется, а JSON будет правильной формы.

Пример с внешними данными

type User = {
  id: number;
  name: string;
};
 
const user = (await response.json()) as User;
 
console.log(user.name.toUpperCase());

Если сервер вернет { "name": null }, код может упасть в runtime, несмотря на тип User.

Что TypeScript не проверяет автоматически

  • форму JSON от сервера;
  • существование DOM-элемента;
  • доступность сети;
  • ошибки в бизнес-логике;
  • деление на ноль;
  • реальное содержимое localStorage;
  • данные из URL или формы.

Как защищаться

function isUser(value: unknown): value is User {
  return (
    typeof value === 'object' &&
    value !== null &&
    typeof (value as { id?: unknown }).id === 'number' &&
    typeof (value as { name?: unknown }).name === 'string'
  );
}

Для внешних данных нужны runtime-проверки, type guards или схемы валидации.

Практический вывод

TypeScript хорош для проверки кода, который ты написал. Все, что приходит извне, нужно считать unknown, пока оно не проверено.

Что важно помнить

  • TypeScript не существует в runtime: данные из сети, localStorage и JSON.parse могут не совпадать с типами.
  • Для проверки данных используют схемы: Zod, Valibot, ArkType — они дают и проверку, и вывод типа.
  • Ошибки логики, гонки и деление на ноль типами не ловятся — нужны тесты.
  • as поверх внешних данных — частая причина «типизированных» runtime-ошибок.

Мини-шпаргалка

TypeScript checks compile-time types
Runtime data still needs validation

Документация

Zod, TypeScript Handbook: Type Assertions.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам