Если вам нужна более продвинутая обработка TypeScript, чем встроенная поддержка (или вы используете Node.js до v22.7.0), у вас есть 2 варианта: использовать runner (который берёт на себя большую часть сложности) или разбираться со всем самостоятельно через транспиляцию.
ts-node — это среда выполнения TypeScript для Node.js. Она позволяет запускать код на TypeScript прямо в Node.js без необходимости сначала его компилировать. По умолчанию ts-node выполняет проверку типов, если не включён transpileOnly. Хотя ts-node может ловить ошибки типов во время выполнения, мы всё же рекомендуем сначала проверять типы вашего кода с помощью tsc, прежде чем выпускать его.
Чтобы использовать ts-node, его сначала нужно установить:
npm i -D ts-nodeЗатем вы можете запускать ваш код на TypeScript так:
npx ts-node example.tstsx — ещё одна среда выполнения TypeScript для Node.js. Она позволяет запускать код на TypeScript прямо в Node.js без необходимости сначала его компилировать. Учтите, однако, что она не проверяет типы вашего кода. Поэтому мы рекомендуем сначала проверить типы вашего кода с помощью tsc, а затем запускать его через tsx, прежде чем выпускать.
Чтобы использовать tsx, его сначала нужно установить:
npm i -D tsxЗатем вы можете запускать ваш код на TypeScript так:
npx tsx example.tsЕсли вы хотите использовать tsx через node, можно зарегистрировать tsx через --import:
node --import=tsx example.ts