Урок 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Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.