Verificação de tipos sem executar a aplicação
O typecheck verifica se os usos de um valor são compatíveis com o tipo conhecido pelo analisador. No TypeScript, esse tipo pode vir de uma anotação escrita no código ou ser inferido a partir de uma atribuição. O verificador compara essas informações ao analisar uma chamada de função ou o acesso a uma propriedade.
Essa análise é estática porque não executa a aplicação para observar o resultado. Sua cobertura depende dos tipos disponíveis e das opções do projeto. Por exemplo, um valor marcado como any permite usos que o verificador recusaria com um tipo mais específico.
Um texto no lugar de um número
O exemplo didático abaixo declara uma função que recebe um preço numérico e calcula um desconto de 10%. A chamada fornece "100", um texto, no lugar de 100, um número.
function aplicarDesconto(preco: number) { return preco * 0.9}
aplicarDesconto("100")O TypeScript aponta a incompatibilidade entre string e number no argumento. Esse diagnóstico vem da análise do código, sem executar o cálculo. Trocar a chamada por aplicarDesconto(100) atende ao tipo declarado, mas a fórmula ainda precisa corresponder ao desconto previsto.
O limite diante de uma resposta externa
As anotações de tipo são removidas do JavaScript gerado e não inspecionam o conteúdo recebido durante a execução. Declarar que uma resposta de uma API (interface de programação de aplicações) contém um preço numérico não confirma que o servidor enviou esse campo no formato esperado.
Você precisa validar a resposta externa ao recebê-la e testar o cálculo com resultados conhecidos. O typecheck pode aceitar uma função que multiplica por 0.8, pois essa fórmula também usa números, embora aplique um desconto diferente do esperado.
Dúvidas frequentes
Perguntas frequentes sobre typecheck
- O typecheck executa a aplicação ou seus testes?
- A verificação estática compara as informações de tipos sem executar a aplicação. Os testes verificam comportamentos com entradas e resultados esperados, por isso as duas verificações cobrem problemas diferentes.
- Anotar o tipo de uma resposta externa valida seu conteúdo?
- A anotação informa ao verificador o formato esperado, mas não examina a resposta durante a execução. O código precisa validar o conteúdo recebido para confirmar que os campos existem e possuem os formatos esperados.
- Por que uma fórmula errada pode passar no typecheck?
- Uma fórmula pode usar apenas números e continuar calculando um desconto incorreto. O sistema de tipos verifica a compatibilidade das operações, mas o resultado esperado precisa ser conferido por testes.
Para continuar
Recursos relacionados
Documentação
TypeScript: verificação estática de tipos
Introdução à análise estática do TypeScript, com inferência de tipos, mensagens de erro e remoção das anotações no JavaScript gerado.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar erros de tipos e conferir o comportamento esperado no código.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.