Configuração com tsconfig.json

O arquivo tsconfig.json especifica o diretório raiz de um projeto TypeScript e as opções do compilador necessárias para construir o projeto.

Sempre que você executa tsc em um diretório de projeto, o compilador procura esse arquivo para orientar seu comportamento de compilação.

Estrutura de um arquivo tsconfig.json

Um arquivo de configuração típico é assim:

{
  "compilerOptions": {
    "target": "es2022",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "outDir": "./dist"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "**/*.spec.ts"]
}

As principais propriedades são:

• compilerOptions: Configurações para o compilador.
• include: Especifica os arquivos ou pastas a serem compilados.
• exclude: Especifica os arquivos ou pastas a serem ignorados durante a compilação.

Principais opções do compilador

Aqui estão algumas das configurações mais importantes que você deve saber:

1. target: Especifica a versão da saída JavaScript do compilador (por exemplo, es5, es6/es2015, es2020, esnext).
2. module: Especifica o sistema de módulos usado no código compilado (por exemplo, commonjs, esnext, node16).
3. strict: permite um amplo conjunto de comportamentos rigorosos de verificação de tipo. É altamente recomendável definir como true para máxima segurança de tipo. Ele permite opções como:
   • noImplicitAny: gera um erro em expressões e declarações com um tipo any implícito quando nenhuma anotação de tipo é fornecida.
   • strictNullChecks: Impede a atribuição de null ou undefined a tipos que não os incluem explicitamente em sua união.

Experimente você mesmo

Exercício 1: Tratamento de strictNullChecks

Exercício 2: digitação estrita sem qualquer implícito