Зачем TypeScript в React-приложении
На этой странице
TypeScript описывает контракты props, state, событий и данных. Проверка типов помогает найти часть ошибок до запуска приложения.
Вопрос
Какие задачи TypeScript решает в React и почему типы не заменяют проверку данных API?
Основная идея
Если кнопке нужен текст, а карточке - объект с именем и ID, эти требования можно выразить типами. Редактор подскажет обязательные поля и обнаружит неподходящий аргумент.
Особенно полезны типы при изменениях: если переименовать prop или поменять формат результата, компилятор покажет места, которые нужно исправить. Для fullstack TypeScript это помогает описывать контракты между слоями, но не обеспечивает их соблюдение удаленной системой автоматически.
Типы удаляются при преобразовании в JavaScript. Сервер может вернуть неожиданный JSON, пользователь - прислать неверные данные. Для таких границ нужна runtime-валидация.
Пример: контракт карточки
type Course = {
id: string;
title: string;
lessons: number;
};
type CourseCardProps = {
course: Course;
onOpen: (id: string) => void;
};
function CourseCard({ course, onOpen }: CourseCardProps) {
return (
<article>
<h2>{course.title}</h2>
<p>Уроков: {course.lessons}</p>
<button onClick={() => onOpen(course.id)}>Открыть</button>
</article>
);
}
export default function App() {
return (
<CourseCard
course={{ id: "react", title: "React", lessons: 12 }}
onOpen={id => console.log("Открываем", id)}
/>
);
}Параметр callback автоматически имеет тип string. Передача lessons: "12" вместо числа вызовет ошибку проверки типов, если не обходить ее через any или утверждения.
Что нужно для проекта
Файлы с JSX и TypeScript имеют расширение .tsx. Нужны совместимые версии typescript, @types/react и @types/react-dom, а также настройка JSX в сборке.
Важно реально запускать проверку, например tsc --noEmit: некоторые сборщики только удаляют типы и не проверяют их.
Что TypeScript ловит в React
| Ошибка | Без TS | С TS |
|---|---|---|
Опечатка в prop: <Card titel="…" /> | Пустой заголовок в рантайме | Ошибка в редакторе |
| Не передан обязательный prop | undefined где-то в глубине | Ошибка при вызове |
Неверный тип: lessons="12" | "12" + 1 = "121" | Ошибка |
| Переименовали поле API | Найти все места вручную | Компилятор покажет каждое |
Неверный тип события e.target.value у div | Падение в рантайме | Ошибка |
Забыли обработать вариант union (status: "error") | Пустой экран | Ошибка при exhaustive check |
Граница доверия: as — не проверка
// ✗ Обещание компилятору: если сервер вернёт { name: "Курс" } без lessons — упадёт позже
const course = (await res.json()) as Course;
// ✓ Проверка во время выполнения схемой, тип выводится из схемы
import { z } from "zod";
const CourseSchema = z.object({
id: z.string(),
title: z.string(),
lessons: z.number().int().nonnegative(),
});
type Course = z.infer<typeof CourseSchema>;
const course = CourseSchema.parse(await res.json()); // бросит понятную ошибку, если формат не тот граница доверия
внешний мир ──────────┃──────────▶ код приложения
(API, формы, ┃ валидация (типы TypeScript
localStorage, URL) ┃ (Zod) гарантируют форму)Ограничения
TypeScript не доказывает правильность бизнес-алгоритма и не предотвращает все исключения. response.json() as Course - обещание компилятору, а не проверка ответа.
Что важно помнить
- TypeScript ловит ошибки props, состояния и API на этапе компиляции.
- Типы служат документацией и улучшают автодополнение и рефакторинг.
- Типы исчезают при сборке — проверку данных из сети делают в рантайме (Zod, Valibot).
- Включайте
strict: trueс самого начала проекта.
Мини-шпаргалка
- Типизируй внешние контракты.
- Используй вывод типов внутри понятного кода.
- Не обходи ошибки через any без причины.
- Проверяй недоверенные данные во время выполнения.
- Добавь typecheck в проверки проекта.