deno transpile

Команда deno transpile генерирует JavaScript из исходных файлов TypeScript, JSX или TSX. Она пригодится, если вам нужен обычный вывод .js для запуска в среде, которая не понимает TypeScript, или чтобы передать его на этап сборки, который ожидает JavaScript.

Для большинства сценариев работы deno transpile не нужен — deno run, deno test и deno serve уже принимают файлы .ts / .tsx напрямую. Используйте эту команду, если:

• Вы поставляете библиотеку пользователям, которые запускают node или непосредственно сборщик для браузера. (Для tarball-пакетов npm предпочтительнее deno pack, который дополняет deno transpile логикой упаковки.)
• Инструмент на следующем этапе понимает только .js.
• Вы хотите включить предварительно скомпилированный .js в артефакт сборки, а не выполнять транспиляцию на лету.

Использование

deno transpile <files...> [flags]

<files> — это один или несколько путей к исходным файлам (шаблоны glob раскрываются оболочкой). deno transpile не обходит каталоги — укажите файлы для транспиляции, при необходимости используя шаблон glob оболочки.

Режимы вывода

# Print to stdout
deno transpile main.ts

# Write to a single file
deno transpile main.ts -o dist/main.js

# Transpile multiple files into an output directory
deno transpile src/main.ts src/helpers.ts --outdir dist

# Use a shell glob
deno transpile src/*.ts --outdir dist

Соответствие расширений входных и выходных файлов

Преобразование JSX, декораторы, целевая версия и другие параметры генерации берутся из compilerOptions в вашем deno.json (или tsconfig.json), поэтому результат соответствует коду, который выполнил бы deno run. Полный список см. в разделе Параметры компилятора TypeScript.

Карты исходного кода

Передайте --source-map с одним из следующих значений:

deno transpile main.ts -o dist/main.js --source-map separate

Объявления типов

Используйте --declaration для генерации файлов объявлений .d.ts. Объявления создаются с помощью tsc (с использованием встроенного TypeScript), поэтому этот флаг учитывает compilerOptions из вашего deno.json / tsconfig.json.

Файлы .d.ts всегда записываются на диск — рядом с исходным файлом, если место вывода не задано, или в --outdir, если оно указано, — даже если вывод JavaScript направляется в стандартный вывод или в один файл -o.

deno transpile src/*.ts --outdir dist --declaration

Отличия от tsc

deno transpile и tsc в TypeScript выполняют похожие задачи, но не являются взаимозаменяемыми:

Чтобы обнаруживать ошибки типов, запускайте deno check до или после транспиляции. deno transpile без проблем сгенерирует код, который не пройдёт проверку типов.

Ограничения

• Без объединения файлов. Для каждого входного файла создаётся один выходной. В импортах меняется только расширение (./foo.ts → ./foo.js), однако для полученного графа по-прежнему нужна среда выполнения, разрешающая импорты. Чтобы получить один файл, используйте deno bundle.
• Каталоги не обходятся. Передача каталога ничего не даст — укажите файлы явно (src/**/*.ts) или используйте шаблон glob.
• Карты исходного кода и стандартный вывод. --source-map inline работает при выводе в стандартный поток; для separate требуется путь вывода, чтобы рядом с ним можно было записать карту.

См. также

• deno bundle — создать один объединённый файл JavaScript
• deno pack — собрать tarball для публикации в npm (внутри использует deno transpile)
• deno check — проверить типы без генерации файлов
• Поддержка TypeScript — обзор работы TypeScript в Deno

deno transpile [OPTIONS] [file]...

deno transpile main.ts

deno transpile main.ts -o main.js

deno transpile src/*.ts --outdir dist

deno transpile main.ts --source-map separate

deno transpile main.ts -o out.js --declaration