Configurações Rigorosas para Produção: Dominando strict: true e Flags Defensivas no tsconfig.json
Configurações Rigorosas para Produção: Dominando strict: true e Flags Defensivas no tsconfig.json
strict: true realmente ativa sob o capô, as flags complementares de higiene estática e como criar um pipeline de qualidade inquebrável em CI/CD com tsc --noEmit!
📑 Índice do Conteúdo
1. A Filosofia do “Zero Any” e o Perigo das Configurações Permissivas
Muitas equipes adotam o TypeScript acreditando que apenas renomear arquivos de .js para .ts trará imunidade contra bugs. Porém, se o arquivo tsconfig.json for configurado de forma frouxa ou mantiver as diretivas padrão desativadas, o compilador permitirá a proliferação silenciosa do tipo any e acessos inseguros a propriedades nulas.
Em ambientes corporativos de missão crítica (bancos, e-commerces, sistemas médicos), a regra de ouro é: o compilador é o seu primeiro e mais rigoroso revisor de código. Para isso, ativamos o Modo Estrito (Strict Mode)!
2. As 8 Flags Mestras do Guarda-Chuva strict: true
A diretiva "strict": true no tsconfig.json não é uma configuração isolada; ela atua como um guarda-chuva mestre que liga simultaneamente 8 verificações profundas de segurança:
| Flag Ativada por strict | Comportamento de Segurança | Problema que Previne |
|---|---|---|
noImplicitAny |
Exige anotação de tipo sempre que o compilador não conseguir inferir automaticamente. | Impede que parâmetros de funções virem any silenciosamente. |
strictNullChecks |
Separa estritamente null e undefined de outros tipos primitivos. |
Elimina o clássico erro fatal Cannot read properties of undefined. |
strictFunctionTypes |
Verifica contravariância estrita nos parâmetros de funções em atribuições. | Previne passagem de funções com parâmetros incompatíveis. |
strictBindCallApply |
Verifica os tipos dos argumentos passados para .bind(), .call() e .apply(). |
Impede invocações com argumentos errados em metaprogramação. |
strictPropertyInitialization |
Exige que todas as propriedades de classe sejam inicializadas no construtor. | Previne campos de classe com valores undefined inesperados. |
noImplicitThis |
Emite erro se o ponteiro this tiver tipo ambíguo em funções normais. |
Evita perda de contexto em callbacks e listeners de eventos. |
alwaysStrict |
Analisa todos os arquivos no modo estrito e emite "use strict"; na saída JS. |
Garante conformidade com as regras modernas do ECMAScript. |
useUnknownInCatchVariables |
Tipa a variável de erro em blocos catch(e) como unknown (em vez de any). |
Obriga o desenvolvedor a fazer narrowing seguro antes de ler e.message. |
3. O Guardião do Erro Bilionário: strictNullChecks em Ação
Tony Hoare, criador da referência nula em 1965, chamou sua invenção de “The Billion Dollar Mistake”. Com strictNullChecks: true, o TypeScript neutraliza esse erro:
// Com strictNullChecks: false (PERIGOSO)
let nome: string = "Renata";
nome = null; // Válido sem erro!
console.log(nome.length); // QUEBRA FATAL EM RUNTIME!
// Com strictNullChecks: true (CORRETO)
let usuarioNome: string = "Renata";
// @ts-expect-error - TS2322: Type 'null' is not assignable to type 'string'.
usuarioNome = null;
// Para aceitar nulo, devemos declarar explicitamente a união:
let clienteNome: string | null = null;
// clienteNome.length; // O compilador BLOQUEIA imediatamente!
if (clienteNome !== null) {
console.log(clienteNome.length); // Válido com afunilamento seguro!
}
4. Flags Complementares de Higiene e Linter de Código
Além do pacote strict, existem flags fundamentais adicionais que transformam o tsc em um linter estático implacável contra código morto e descuidos:
{
"compilerOptions": {
/* 1. Código Morto e Variáveis Esquecidas */
"noUnusedLocals": true, /* Erro se declarar variável local e não usar */
"noUnusedParameters": true, /* Erro se receber parâmetro em função e não usar */
/* 2. Controle de Fluxo e Casos Faltantes */
"noImplicitReturns": true, /* Garante retorno explícito em todos os if/else */
"noFallthroughCasesInSwitch": true,/* Impede vazamento entre cases de switch sem break */
/* 3. Rigor Máximo em Propriedades */
"exactOptionalPropertyTypes": true /* Diferencia { campo?: string } de { campo: undefined } */
}
}
5. O Quality Gate de CI/CD: npx tsc –noEmit
Em pipelines corporativos modernos de Integração Contínua (GitHub Actions, GitLab CI, Jenkins), a checagem de tipos estática deve ser executada como uma etapa bloqueadora antes de qualquer merge de Pull Request:
# Executa a checagem rigorosa de tipos SEM gerar arquivos em disco:
npx tsc --noEmit
Se qualquer membro da equipe introduzir uma quebra de contrato, uma variável com any implícito ou um acesso nulo sem checagem, o comando encerrará com código de saída diferente de zero (exit code 1), bloqueando a esteira de deploy automaticamente!
6. Exemplo Enterprise: Arquivo tsconfig.prod.json Completo
Vejamos a configuração definitiva adotada por grandes empresas de tecnologia para compilação segura de produção:
{
"compilerOptions": {
/* Alvo e Resolução de Módulos */
"target": "ES2022",
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"module": "ESNext",
"moduleResolution": "Bundler",
"baseUrl": ".",
"paths": {
"@/*": ["src/*"]
},
/* Modo Estrito Master (Ativa as 8 flags) */
"strict": true,
/* Endurecimento Adicional de Código */
"noUnusedLocals": true,
"noUnusedParameters": true,
"noImplicitReturns": true,
"noFallthroughCasesInSwitch": true,
"noUncheckedIndexedAccess": true, /* Indexar array T[number] retorna T | undefined */
"forceConsistentCasingInFileNames": true,
/* Saída e Emissão */
"declaration": true,
"declarationMap": true,
"sourceMap": true,
"outDir": "./dist",
"removeComments": true,
"skipLibCheck": true /* Pula checagem interna de .d.ts de terceiros para acelerar build */
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist", "**/*.spec.ts", "**/*.test.ts"]
}
7. Armadilhas Comuns e Boas Práticas Sênior
- Prefira
@ts-expect-errorem vez de@ts-ignore: O comentário// @ts-ignoresilencia o erro para sempre, mesmo se uma refatoração futura corrigir o problema. O// @ts-expect-errorexige que um erro exista naquela linha; se o erro for corrigido, o TypeScript avisará que a anotação está obsoleta, mantendo o código limpo. - A Flag
noUncheckedIndexedAccess: Por padrão, acessarmeuArray[0]retornaElemento. Ao ativar"noUncheckedIndexedAccess": true, o compilador infereElemento | undefined, forçando você a verificar se o array realmente contém itens antes de acessá-los. - Acelere o Build com
skipLibCheck: true: Essa flag instrui o compilador a pular a verificação de tipo de arquivos.d.tsdentro denode_modules/. Isso reduz o tempo de compilação em até 60% sem comprometer a segurança do seu próprio código.
Resumo da Lição 45 (Marco de 90% Concluído!)
- A diretiva
"strict": trueé mandatória em produção e ativa 8 flags simultâneas de segurança. strictNullChecksimpede o erro de acesso a propriedades denulleundefined.useUnknownInCatchVariablesforça o tratamento seguro de erros em blocoscatch.- Flags de higiene como
noUnusedLocalsenoImplicitReturnsgarantem código limpo e previsível. - O comando
tsc --noEmitatua como Quality Gate inquebrável em pipelines de Integração Contínua (CI/CD).
📝 Exercício Prático Desafiador da Lição 45
1. Crie uma função calcularDesconto(preco: number, cupom?: string) que retorne um número. Com a flag noImplicitReturns: true ativa, garanta que todos os caminhos condicionais (com ou sem cupom válido) retornem explicitamente um valor numérico.
2. Em um bloco try/catch com a flag useUnknownInCatchVariables: true, escreva o tratamento correto para a variável erro usando instanceof Error para exibir erro.message com total segurança de tipo.
Aplique o que você aprendeu nesta lição
Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground Web Online
Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.
⚡ Codificar no Playground IDE