Configurações de compilação do TypeScript

Ao compilar arquivos TypeScript a partir da linha de comando, o compilador permite definir várias configurações. Temos acesso a uma ampla gama de configurações, cujo lista completa pode ser encontrada na página de Parâmetros de Compilação do TypeScript. Vamos revisar apenas as principais.

Recompilação Automática

A opção --watch, ou sua versão abreviada -w, recompila automaticamente os arquivos TypeScript sempre que alguma alteração for feita neles. Isso elimina a necessidade de inserir manualmente o comando no console a cada pequena modificação no código.

tsc -w app.ts

Versão do ECMAScript

Com a opção --target, ou sua versão abreviada -t, é possível definir a versão do padrão JavaScript para o qual o código TypeScript será compilado. Esta opção aceita os seguintes valores: "ES3" (padrão), "ES5", "ES6" / "ES2015", "ES7" / "ES2016", "ES2017", "ES2018", "ES2019", "ES2020" ou "ESNext":

tsc app.ts -t ES5

Remoção de Comentários

Por padrão, todos os comentários presentes nos arquivos TS são transferidos para os arquivos JavaScript gerados. Para remover os comentários durante a compilação, utilize a opção --removeComments:

tsc app.ts --removeComments

Definição de Diretório

Através da opção --outDir, é possível definir uma pasta para armazenar os arquivos JavaScript compilados:

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

Neste caso, o arquivo compilado app.js será salvo na pasta D:\ts\js.

Unificação de Arquivos

Se houver vários arquivos TS, a opção --outFile permite combiná-los em um único arquivo JavaScript:

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

Aqui, os arquivos app.ts e hello.ts serão compilados em um único arquivo output.js.

Tipo de Módulo

Com a opção --module, ou sua forma abreviada -m, é possível especificar o tipo de módulo a ser usado na compilação. Esta opção pode aceitar os seguintes valores: "None", "CommonJS" (padrão se a versão ECMAScript for "ES3" ou "ES5"), "AMD", "System", "UMD", "ES2015", "ES2020" e "ESNext":

tsc -m commonjs app.ts

Múltiplos Parâmetros

Se for necessário definir vários parâmetros, basta listá-los junto com seus valores, separados por espaços:

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

Ajuda

Para visualizar todos os parâmetros disponíveis e obter mais informações sobre eles, use a opção -h:

tsc -h