ExpertiDict

TypeScript · Intermediário · Inglês · Técnico

satisfies

/ˈsætɪsfaɪz/palavra-chave

Operador que verifica se uma expressão é compatível com um tipo sem alterar o tipo inferido dela. Valida o formato e preserva literais e chaves específicas.

Onde usar

Substitui a anotação em objetos de configuração: com satisfies Record<string, Rota> você ganha erro em campos errados e continua com autocompletar nas chaves reais. Chegou no TS 4.9.

Em código

type Cor = string | [number, number, number];
const paleta = {
  rosa: [255, 0, 128],
  azul: '#00f',
} satisfies Record<string, Cor>;
paleta.rosa.map((n) => n / 2); // é array
paleta.azul.toUpperCase();     // é string

Exemplos

Use satisfies to validate the config without losing the literal types.

Use satisfies para validar a configuração sem perder os tipos literais.

With satisfies the keys still autocomplete.

Com satisfies as chaves continuam no autocompletar.

Cuidado

Não é uma asserção as: o satisfies não converte nem força nada, só confere, e se o valor não servir o erro aparece na hora.

Antônimos

as

Veja também

Todos os termos de TypeScript