TypeScript · Essencial · Inglês · Técnico
union type
Tipo formado pelo operador |, que aceita valores de qualquer um dos tipos listados. Para usar o valor, é preciso estreitar o tipo até saber qual caso ocorreu.
Onde usar
Aparece quando uma função aceita 'string ou número' ou devolve 'resultado ou null'. O compilador só libera os membros comuns a todas as opções até você fazer narrowing.
Em código
function id(v: string | number) {
if (typeof v === 'string') return v.trim();
return v.toFixed(0);
}
let x: 'a' | 'b' | null = null;Exemplos
This param is a union type, so check typeof before using it.
Esse parâmetro é um union type, então verifique o typeof antes de usá-lo.
The API returns a union of success and error shapes.
A API retorna uma união dos formatos de sucesso e de erro.
Cuidado
Não confunda com intersection type: A | B é um valor de A ou de B, enquanto A & B é um valor que tem tudo de A e de B ao mesmo tempo.
Sinônimos
tipo união
Antônimos
intersection type