Sanyanggae LogoSanyanggae

📱 Des. Mobile

Tipos condicionais TypeScript e infer: transformar tipos com pequenos exemplos

Explore tipos condicionais, distribuição de uniões e literais de modelo, distinguindo-os da validação em execução.

사냥개 (Sanyanggae)Publicado Atualizado 8 min de leitura

Este artigo é uma tradução do original em coreano. Original em coreano · Revisão da tradução: Revisão por IA

Diagrama explicativo: Tipos condicionais · infer e distribuição · Validação em execução. Tipos condicionais TypeScript e infer: transformar tipos com pequenos exemplos
SANYANGGAE · Diagrama explicativo · Tipos condicionais · infer e distribuição · Validação em execução.

Declarações semelhantes repetidas no TypeScript convidam a calcular a saída a partir do tipo de entrada. Mais que poupar caracteres, importa a clareza da relação entre tipos. Um serviço fictício de avisos de entrega permite estudar tipos condicionais e infer, distinguindo-os da verificação real de dados externos.

1. O tipo condicional decide segundo um tipo de entrada

A documentação oficial explica escolher o resultado com uma condição extends. O exemplo produz um tipo literal booleano conforme a entrada seja string. Não é função verificando strings em execução.

type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>;       // false

Suponha avisos com identificador string e processamento interno com identificador numérico. Antes de aplicar tipos condicionais, explique por que diferem. Nomes separados ajudam quando os sentidos diferem; se só muda a notação, unificar a entrada pode ser mais legível. Não esconda ambiguidades dos dados com técnicas de tipos.

Anote pares de entrada e saída esperadas. Pequenos exemplos de strings, números, uniões e entradas inesperadas reduzem o esforço para ler declarações complexas. Confira comentários contra a inferência do editor. Um nome natural não garante o resultado calculado.

2. Distribuir uniões muda o sentido dos arrays

Com o parâmetro diretamente à esquerda da condição, ela se distribui por cada membro da união. Para tratar toda a união como uma unidade, compare a forma envolvida em colchetes.

type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>;      // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];

O primeiro resultado é um array só de strings ou só de números. O segundo permite ambos no mesmo array. A escolha depende de toda a lista de entregas exigir um tipo de código ou permitir variação por item. Ambos mostram colchetes, mas têm contratos distintos.

Ao depurar, forneça um membro por vez em vez de ler todo um utilitário complexo. Compare string, número e união dos dois. Saber se a distribuição era desejada explica os colchetes. Registre valores permitidos como exemplo, além do resultado final.

3. infer nomeia um tipo dentro da estrutura

Em tipos condicionais, infer nomeia parte da estrutura reconhecida. Este pequeno tipo remove uma camada de Promise.

type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;

O código não executa nem espera trabalho assíncrono: expressa a forma do resultado na compilação. Um nome de função como Resolved pode sugerir que o valor já chegou; examine o contexto de uso do tipo. A espera real continua no código assíncrono.

Para resultado aguardado recursivamente, consulte o utilitário padrão Awaited antes de ampliar o exemplo de uma camada. Simplicidade didática difere de requisitos de ferramenta compartilhada. Documente entradas com resultado distinto do padrão e a razão necessária ao introduzir um utilitário na equipe.

4. Formar nomes de eventos com literais de modelo

Tipos literais de modelo representam combinações de literais string. O serviço de entrega pode combinar âmbito e ação em nomes de evento.

type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';

A compilação detecta erros de escrita, mas a validade de todas as combinações no serviço é outra questão. Se só se aceita excluir endereço, um simples produto de âmbitos e ações pode representar mal a regra. Considere primeiro mapear explicitamente eventos permitidos e payload.

Quanto mais eventos, mais importante encontrar seus nomes reais. Em vez de encadear regras automáticas, reúna num arquivo os nomes enviados a sistemas externos. Compare como alguém novo encontraria um evento incorreto antes e depois da abstração. Avalie sofisticação e usabilidade juntas.

5. Verificar JSON externo durante a execução

Anexar User ou Parcel a uma resposta API não garante sua estrutura real. Vejamos como receber valor externo em unknown e verificar campos necessários.

function hasTracking(value: unknown): value is { tracking: string } {
  return typeof value === 'object' && value !== null
    && 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);

Só se verifica se tracking é string. Não se confirma a existência do código nem a autorização para consultar a entrega. Estreitamento de tipos, regras de negócio e autorização são responsabilidades separadas. A documentação oficial de narrowing explica como condições refinam tipos.

6. Uma breve sequência para escolher ferramentas de tipos

Escreva dois valores reais permitidos e dois rejeitados. Expresse depois o sentido com uniões comuns e objetos explícitos. Use tipos condicionais ou infer quando restarem relações repetidas, tornando clara a finalidade. Se a leitura ficar muito mais demorada, extraia só o comum e mantenha o resto simples.

Execute separadamente testes de tipos e de execução. Verificar se o compilador rejeita um evento inválido complementa testar se o programa explica erros quando faltam campos do servidor. Confira pequenos exemplos e conecte-os às fronteiras de entrada reais para contribuir com uma aplicação segura.

Fontes e referências

Este artigo explica informações de fontes públicas. A citação de uma instituição não implica revisão nem aprovação por ela.

Editora e contato

Outros artigos sobre o tema