Como o discriminador identifica o tipo
Uma tagged union, ou união discriminada, é um tipo formado por alternativas identificadas por um campo comum. Cada alternativa usa um valor diferente nesse campo, chamado de discriminador. Assim, uma resposta de sucesso pode exigir o endereço de um arquivo e uma resposta de falha pode exigir uma mensagem de erro.
O TypeScript acompanha as comparações feitas no código para identificar qual alternativa pode existir em cada trecho. Ao comparar o discriminador com um valor literal, como "sucesso", o compilador restringe o tipo à variante correspondente e reconhece suas propriedades.
Uma resposta de exportação
Neste exemplo didático, a função recebe o resultado de uma exportação e retorna o texto que a interface deve apresentar:
type Resultado = | { tipo: "sucesso"; endereco: string } | { tipo: "falha"; mensagem: string }
function textoDoResultado(resultado: Resultado): string { if (resultado.tipo === "sucesso") { return resultado.endereco }
return resultado.mensagem}Uma entrada com tipo: "sucesso" e endereco: "/arquivos/relatorio.csv" faz a função retornar esse endereço. No outro caminho, ela retorna a mensagem da falha. O discriminador relaciona o estado da exportação aos campos disponíveis, por isso o código não precisa considerar o endereço como uma propriedade opcional de toda resposta.
O limite da análise do TypeScript
A declaração descreve os formatos aceitos pelo compilador, mas uma resposta externa pode chegar sem o endereço ou com um discriminador desconhecido. Escrever as Resultado apenas informa um tipo ao TypeScript e não verifica o JSON recebido.
Você precisa validar o conteúdo na entrada da aplicação para usá-lo como Resultado. Um teste com tipo: "sucesso" e o campo endereco ausente deve confirmar que a validação recusa a resposta malformada. A função do exemplo pressupõe que essa conferência já ocorreu.
Dúvidas frequentes
Perguntas frequentes sobre tagged union
- Como escolher o campo discriminador?
- Use um campo presente em todas as variantes e atribua a ele um valor literal distinto em cada uma. O campo pode se chamar tipo, estado ou outro nome que descreva a mensagem.
- A união discriminada valida um JSON recebido?
- A declaração do tipo não faz essa validação. A aplicação precisa conferir o discriminador e os campos da variante durante a execução. Uma asserção de tipo também não verifica o conteúdo.
- Todas as variantes precisam ter os mesmos campos?
- Elas compartilham o discriminador, mas podem ter outros campos diferentes. Após identificar a variante, o TypeScript permite acessar as propriedades específicas dela.
Para continuar
Recursos relacionados
Documentação
TypeScript: uniões discriminadas
Mostra como uma comparação do campo comum permite ao TypeScript identificar os campos de cada variante.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão prática com orientação ao vivo para você revisar a modelagem dos tipos e a validação das respostas no seu código.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Os tipos das respostas do sistema podem distinguir sucesso e falha sem misturar campos incompatíveis.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.