Настройки компиляции

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

Автоматическая перекомпиляция

Опция --watch, а также ее сокращенная версия -w автоматически перекомпилирует файлы typescript, если в них были внесены какие-либо изменения. Благодаря чему не надо при каждом малейшем изменении вручную вводить команду в консоль для перекомпиляции.

tsc -w app.ts

Версия ECMAScript

С помощью параметра –-target или его сокращенной версии –t можно задать версию стандарта JavaScript, в которую будет компилироваться код TypeScript. Этот параметр может принимать следующие значения: "ES3" (по умолчанию), "ES5", "ES6" / "ES2015", "ES7" / "ES2016", "ES2017", "ES2018", "ES2019", "ES2020" или "ESNext":

tsc app.ts -t ES5

Удаление комментариев

По умолчанию в файлы javascript переходят все комментариии, которыми снабжен код в файлах TS. Удаление комментариев при компиляции осуществляется с помощью параметра –-removeComments:

tsc app.ts --removeComments

Установка каталога

С помощью параметра --outDir можно задать папку для хранения скомпилированных файлов js:

tsc --outDir D:\ts\js app.ts

В данном случае скомпилированный файл app.js окажется в папке D:\ts\js

Объединение файлов

Если у нас несколько файлов TS, то с помощью параметра --outFile их можно объединить в один файл js:

tsc --outFile output.js app.ts hello.ts

Здесь файлы app.ts и hello.ts скомпилируются в один файл output.js

Тип модуля

С помощью параметра --module, либо -m можно указать тип модуля, который будет использоваться для компиляции. Эта опция может принимать следующие значения: "None", "CommonJS" (значение по умолчанию, если задана версия ECMAScript "ES3" или "ES5"), "AMD", "System", "UMD", "ES2015", "ES2020" и "ESNext".

tsc -m commonjs app.ts

Несколько параметров

Если надо задать несколько параметров, то они и их значения последовательно перечисляются через пробел.

tsc -t ES5 --outDir js -m commonjs app.ts

Вызов справки

И чтобы посмотреть все доступные параметры и справку по ним, можно воспользоваться параметром -h:

tsc -h