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

Зачем 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="…" />Пустой заголовок в рантаймеОшибка в редакторе
Не передан обязательный propundefined где-то в глубинеОшибка при вызове
Неверный тип: 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 в проверки проекта.

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

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

Поиск

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