Bezdepbonusu7Программирование: статьи и ответы

TypeScript

TypeScript с нуля: установка, типы, интерфейсы и настройка

TypeScript - это JavaScript с типами: компилятор находит ошибки до запуска программы и превращает код в обычный JavaScript. В статье установка через npm, tsc --init, базовые типы, разница interface и type, union, generics и режим strict.

TypeScript с нуля: установка, типы, интерфейсы и настройка
Содержание
  1. Зачем нужен TypeScript и чем он отличается от JavaScript
  2. Установка TypeScript и первый запуск
  3. Базовые типы
  4. Interface и type: как описать форму объекта
  5. Union, сужение типов и generics
  6. Настройка tsconfig.json и режим strict
  7. Типы для библиотек, проверка в CI и частые ошибки
  8. Частые вопросы

Зачем нужен TypeScript и чем он отличается от JavaScript

TypeScript - это JavaScript с системой типов. Любой корректный код на JavaScript уже является корректным TypeScript, а к нему добавляется возможность указать, какого типа значение хранит переменная, что принимает функция и что она возвращает. Браузер и Node.js сам TypeScript не понимают: код сначала проверяется и превращается в обычный JavaScript.

Главная выгода в том, что ошибки находятся до запуска. Опечатка в имени поля, вызов функции с лишним аргументом, обращение к значению, которое может быть undefined, - всё это редактор подчёркивает прямо при вводе. Вторая выгода - подсказки: по типам редактор знает, какие поля есть у объекта, и надёжно переименовывает их по всему проекту.

Цена тоже есть: нужен шаг сборки, нужно описывать типы, а при работе с чужими библиотеками иногда приходится ставить пакеты с типами. Для маленького скрипта на десять строк TypeScript избыточен, а для проекта из десятков файлов и команды из нескольких человек почти всегда окупается. Если вы только осваиваете основы языка, сначала разберитесь с JavaScript, например с методами массивов.

Установка TypeScript и первый запуск

Понадобится Node.js и менеджер пакетов npm. Если их ещё нет, смотрите установку Node.js и основные команды npm. Компилятор обычно ставят в проект как зависимость для разработки, а не глобально: так у всех участников команды одна и та же версия.

Команды создают папку проекта, файл package.json, ставят компилятор и генерируют файл настроек tsconfig.json:

mkdir ts-demo
cd ts-demo
npm init -y
npm i -D typescript
npx tsc --init
npx tsc -v

Последняя команда выведет номер установленной версии. Сейчас актуальна ветка 6.x; точную версию смотрите на странице пакета typescript в npm. Команда npx tsc запускает компилятор из папки node_modules проекта.

Терминал с командами установки и сборки TypeScript
Установка и сборка проекта на TypeScript

Создайте файл src/index.ts и впишите простую функцию с типами параметров:

function greet(name: string, times: number): string {
  return `Привет, ${name}! `.repeat(times).trim();
}

console.log(greet("мир", 2));

Запуск в два шага: npx tsc создаст JavaScript в папке dist, затем node dist/index.js выведет строку дважды. Если передать в greet число вместо строки, компилятор остановится с ошибкой и подскажет, какой аргумент неверный.

Есть и более короткие пути. В современных версиях Node.js (линейка 22.18 и новее, а также 24) файл с типами можно запустить напрямую командой node src/index.ts: типы просто вырезаются, но проверки не происходит (enum и другой синтаксис, требующий преобразования, не поддерживается), поэтому tsc --noEmit всё равно нужен. Для разработки популярен пакет tsx, он запускает TypeScript без отдельной сборки. Попробовать код без установки можно на сайте typescriptlang.org/play.

Базовые типы

Тип указывается после имени через двоеточие. В большинстве случаев его не нужно писать вручную: если переменной сразу присвоено значение, TypeScript выводит тип сам.

const title: string = "Заметки";
const count: number = 3;
const done: boolean = false;
const tags: string[] = ["ts", "js"];
const pair: [string, number] = ["возраст", 30];

let id = 10;      // тип number выведен автоматически
// id = "abc";    // ошибка: строку нельзя присвоить числу

Здесь string, number и boolean - примитивы, string[] - массив строк, а запись в квадратных скобках с двумя типами - кортеж из строки и числа в строгом порядке. Последняя строка закомментирована, раскомментируйте её, чтобы увидеть сообщение компилятора.

Особые типы стоит запомнить сразу:

  • any отключает проверку для значения. Это запасной выход, который быстро превращает TypeScript в обычный JavaScript, поэтому его лучше избегать.
  • unknown - безопасная замена any: значение можно принять откуда угодно, но перед использованием нужно проверить тип.
  • void указывают функциям, которые ничего не возвращают.
  • never означает значение, которое не может появиться, например результат функции, всегда выбрасывающей ошибку.
  • null и undefined - отдельные типы, которые при включённом strict не подмешиваются в другие.

Interface и type: как описать форму объекта

Объекты описывают двумя способами. Оба дают одинаковую проверку, а различия проявляются в деталях расширения и объединения.

interface User {
  id: number;
  name: string;
  email?: string;   // необязательное поле
  readonly role: "admin" | "user";
}

type Point = { x: number; y: number };

const u: User = { id: 1, name: "Аня", role: "user" };
const p: Point = { x: 5, y: 8 };

Знак вопроса делает поле необязательным, readonly запрещает изменять поле после создания. Значение role ограничено двумя строками: это уже пример объединения, о котором речь ниже.

Возможностьinterfacetype
Описание объектаДаДа
РасширениеЧерез extendsЧерез пересечение &
Объединение с одноимённымДа, объявления сливаютсяНет, будет ошибка
Union, кортежи, примитивные псевдонимыНетДа
Реализация классом (implements)ДаДа, если это форма объекта

Практичное правило: для публичных форм объектов и классов берите interface, для объединений, кортежей и вычисляемых типов - type. Главное, чтобы в проекте был единый стиль. Про разницу интерфейса и класса есть отдельное обсуждение на сайте.

Union, сужение типов и generics

Объединение (union) задаёт значение одного из нескольких типов. Перед использованием TypeScript требует проверить, какой именно тип пришёл, и после проверки внутри ветки тип сужается.

type Id = number | string;

function show(id: Id): string {
  if (typeof id === "number") {
    return id.toFixed(0);    // здесь id точно number
  }
  return id.toUpperCase();   // а здесь точно string
}

console.log(show(42), show("ab1"));

Вызов выведет 42 AB1. Проверка typeof - самый простой способ сужения; также работают instanceof, проверка наличия поля через in и сравнение с литералом.

Дженерики позволяют писать функции и типы, не привязанные к одному типу, и при этом не терять информацию о нём:

function first<T>(items: T[]): T | undefined {
  return items[0];
}

const n = first([10, 20, 30]);    // тип number | undefined
const s = first(["a", "b"]);      // тип string | undefined

interface ApiResponse<T> {
  data: T;
  ok: boolean;
}
const res: ApiResponse<string[]> = { data: ["x"], ok: true };

Буква T - параметр типа, его значение определяется по аргументу. Результат first включает undefined, потому что массив может оказаться пустым, и компилятор заставит это учесть. Такие же дженерики используются в ответах API, когда форма данных зависит от запроса.

Настройка tsconfig.json и режим strict

Файл tsconfig.json описывает, как компилировать проект. Команда tsc --init создаёт его с минимальным набором параметров, остальное добавляется вручную. Рабочий вариант для небольшого проекта:

{
  "compilerOptions": {
    "target": "es2022",
    "module": "nodenext",
    "rootDir": "src",
    "outDir": "dist",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src"]
}

Параметры rootDir и outDir разделяют исходники и результат, include ограничивает проверку папкой src. Параметр strict - самый важный: он включает набор строгих проверок разом.

ПараметрЧто делает
strictВключает все строгие проверки сразу; в новых проектах оставляйте true
noImplicitAnyЗапрещает молча выводить any там, где тип не определён
strictNullChecksНе позволяет использовать null и undefined как обычные значения
noEmitТолько проверяет типы, не создавая JavaScript
targetВерсия JavaScript на выходе
outDirПапка для скомпилированных файлов

Не отключайте strict, чтобы быстро убрать красные подчёркивания: ошибки не исчезнут, они просто проявятся в работе программы. Если переносите старый JavaScript-проект, включайте строгость постепенно и правьте файлы по одному.

Типы для библиотек, проверка в CI и частые ошибки

Многие библиотеки уже поставляют свои типы. Для остальных типы лежат в отдельных пакетах с префиксом @types, например npm i -D @types/node даёт описание встроенных модулей Node.js. В проектах на TypeScript 6 перечень подключаемых пакетов типов задаётся параметром types в tsconfig, поэтому при ошибке вида "не найдено имя process" проверьте именно его.

Проверку типов удобно запускать отдельным скриптом. Добавьте в package.json строки и вызывайте их через npm:

"scripts": {
  "build": "tsc",
  "typecheck": "tsc --noEmit"
}

Команды npm run build и npm run typecheck теперь работают одинаково у всей команды и в автоматической сборке. Хороший редактор подскажет типы без запуска, настройку смотрите в материале про VS Code.

Самые частые ошибки новичков: использовать any для всего подряд, приводить значение к нужному типу через as без проверки и забывать, что типы существуют только до компиляции. Если данные приходят из сети, например в формате JSON, тип описывает ожидание, но не гарантирует его: содержимое нужно проверять при чтении.

Когда базовые вещи освоены, переходите к утилитарным типам вроде Partial, Pick и Omit, к перечислениям и к настройке TypeScript в связке с React или Vite. Выбор направления разработки обсуждается в статье frontend или backend.

Частые вопросы

Что такое TypeScript простыми словами?

Это надстройка над JavaScript, которая добавляет проверку типов. Код на TypeScript компилируется в обычный JavaScript, который выполняют браузер и Node.js.

Как установить TypeScript через npm?

В папке проекта выполните npm i -D typescript, затем npx tsc --init для создания tsconfig.json. Проверить версию можно командой npx tsc -v.

Нужно ли учить JavaScript перед TypeScript?

Да, TypeScript строится на JavaScript, и без понимания функций, объектов и массивов типы будут казаться набором непонятных правил.

Чем interface отличается от type?

Interface удобен для описания объектов и классов и умеет сливаться с одноимённым. Type универсальнее: подходит для union, кортежей и псевдонимов.

Как запустить файл .ts?

Скомпилируйте командой npx tsc и запустите результат через node. Также можно использовать пакет tsx или запускать .ts напрямую в новых версиях Node.js, но без проверки типов.

Что делает strict в tsconfig?

Включает набор строгих проверок, включая noImplicitAny и strictNullChecks. Для новых проектов его рекомендуется оставлять включённым.

Источники

  • TypeScript Documentation, Microsoft
  • TSConfig Reference, Microsoft
  • The TypeScript Handbook, Microsoft

TypeScriptJavaScript

Похожие материалы

Версии программ и команды проверены на дату публикации. Если что-то изменилось, сверяйтесь с официальной документацией. Нашли неточность? Напишите на admin@bezdepbonusu7.win.