Зачем нужен 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 проекта.

Создайте файл 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 ограничено двумя строками: это уже пример объединения, о котором речь ниже.
| Возможность | interface | type |
|---|---|---|
| Описание объекта | Да | Да |
| Расширение | Через 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.
