Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é tagged union?

    Uma tagged union reúne tipos com um campo que identifica cada variante. No TypeScript, esse campo orienta o acesso às propriedades de sucesso ou falha.

    Também chamado de: união discriminada, discriminated union, união etiquetada

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano