1001Ferramentas
🔷Dev

Gerador tsconfig (Base)

Gera um tsconfig.json base sem strict mode, ideal para migrar projetos JS para TS gradualmente.



  

tsconfig sem strict para migrar aos poucos

Você tem uma base JavaScript grande e quer começar a usar TypeScript sem parar o time por uma semana. Ligar strict no primeiro dia costuma render umas quatrocentas mensagens de erro e desanimar todo mundo. O que se precisa nessa fase é de um tsconfig frouxo, que aceite arquivos .js ao lado dos .ts e compile sem discutir.

A página não tem campos: o bloco já vem escrito e o botão Gerar só reimprime o mesmo JSON. São target ES2020, module commonjs, allowJs true, strict false, esModuleInterop, skipLibCheck, outDir dist, include de src e exclude de node_modules. O detalhe que passa batido é o allowJs sem checkJs: seus arquivos .js entram na compilação, mas ninguém verifica os tipos deles.

Use isso como ponto de partida, não como destino. O caminho que funciona é ligar uma flag por vez, na ordem noImplicitThis, strictNullChecks, noImplicitAny, resolvendo os erros de cada etapa antes da próxima. Para checar um arquivo JS específico sem mexer no config, ponha // @ts-check no topo dele. Em projeto novo, comece direto pelo gerador strict. Tudo é montado no navegador.

Perguntas frequentes

Qual a diferença para o gerador strict?
Este vem com strict false, allowJs true, target ES2020 e module commonjs. O outro liga strict e mais três checagens, e assume um bundler moderno.
Meus arquivos .js vão ser checados?
Não. allowJs faz o tsc compilá-los, mas sem checkJs os tipos não são verificados. Adicione checkJs: true no config, ou // @ts-check arquivo por arquivo.
Quando devo abandonar essa configuração?
Quando a maior parte do código já for .ts e os erros com strictNullChecks couberem em uma tarde. Aí troque pelo tsconfig strict.

Ferramentas Relacionadas