TypeScript без сборки: запускаем код напрямую в Node.js

native TypeScript в Node.js можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Современный Node.js умеет удалять стираемые типы и выполнять многие .ts-файлы без отдельной сборки. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.

Для первого серверного скрипта связка компилятора, загрузчика и каталога dist иногда скрывает сам TypeScript за настройкой инструментов. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте типизированный CLI-скрипт со списком задач, который запускается командой node tasks.ts. Проверка: Node печатает две задачи, TypeScript отдельно находит намеренную ошибку типов, а JavaScript-файл сборки не создаётся.

Как устроен учебный проект native TypeScript в Node.js

Node удаляет только синтаксис типов перед выполнением, а проверку типов по-прежнему выполняет команда tsc --noEmit. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.

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

От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Собираем рабочий пример шаг за шагом

Пример рассчитан на современный Node.js с включённым type stripping и сверялся с официальной документацией Node. Создайте проект командой npm init -y и установите только проверяющие типы пакеты: npm i -D typescript @types/node. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.

type Task = {
  id: number
  title: string
  done: boolean
}

function openTasks(tasks: Task[]): Task[] {
  return tasks.filter((task) => !task.done)
}

const tasks: Task[] = [
  { id: 1, title: "Разобрать типы", done: true },
  { id: 2, title: "Запустить .ts", done: false },
  { id: 3, title: "Добавить тест", done: false },
]

for (const task of openTasks(tasks)) {
  console.log(task.id + ". " + task.title)
}

Во время запуска Node удаляет аннотации : Task, но не доказывает их правильность. Поэтому быстрый запуск и статическая проверка остаются двумя командами. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

Поддерживаемый режим называется type stripping: типы должны быть стираемыми, то есть после удаления оставлять валидный JavaScript. Node не читает tsconfig.json как компилятор и не преобразует произвольный синтаксис. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Импорты локальных TypeScript-файлов записывайте с расширением .ts. Для проверки таких импортов TypeScript предлагает опцию allowImportingTsExtensions.

Не называйте этот режим полноценной компиляцией TypeScript. Декораторы, enum, namespace с runtime-кодом и некоторые parameter properties требуют преобразования, а не простого удаления. Для большого приложения сборщик всё ещё может отвечать за оптимизацию, совместимость и пути модулей. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверяем проект и добавляем свою функцию

Разделите тип Task и функцию openTasks в отдельный файл, импортируя его по точному пути с расширением .ts. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

Нативный запуск особенно удобен для небольших CLI, скриптов миграции и учебных примеров, где отдельная папка сборки не даёт пользы. Полезная правка проходит от нового ввода до видимого результата.

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Оставьте две команды в scripts: start для Node и check для tsc. В CI запускайте проверку типов, даже если локально файл стартует напрямую. Для закрепления откройте в первом проекте TypeScript, в REST API на Node.js и в проверке данных через Zod.

Как изучить тему в Кодике

Сначала поймите, какие конструкции TypeScript исчезают после проверки, а какие должны превратиться в runtime JavaScript. Сначала восстановите главную функцию и проверьте её на трёх значениях.

После этого сравните один и тот же файл до и после ручного удаления типов: оставшийся код должен быть обычным JavaScript. Базовый синтаксис закрепите через курс JavaScript.

Что получится в итоге

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