satisfies versus Asserção as
Entenda por que satisfies é mais seguro do que converter tipos com as.
satisfies versus Asserção as é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 4 aulas no total.
O Que o Operador as Faz
A asserção as diz ao compilador para confiar em você quanto a um tipo. Ela não verifica se o valor realmente é compatível; apenas substitui o tipo inferido.
const value = { color: "red" } as { color: string; size: number };
// No error even though size is missing!
console.log(value.color);as Ignora a Segurança
Como as ignora a validação, pode ocultar erros reais. O objeto acima não contém size, mas TypeScript permanece em silêncio.
type Config = { color: string; size: number };
const broken = { color: "red" } as Config;
// broken.size is typed number but is actually undefined at runtime
console.log(broken.size); // undefinedsatisfies Valida em Vez Disso
Substituir as por satisfies transforma esse erro silencioso em um erro claro de compilação, porque o objeto realmente precisa corresponder ao tipo.
type Config = { color: string; size: number };
// const c = { color: "red" } satisfies Config; // Error: size missing
const c = { color: "red", size: 10 } satisfies Config;
console.log(c.size);as Pode Forçar Tipos Incorretos
Você pode até afirmar tipos completamente incompatíveis com uma asserção dupla, o que é perigoso e deve ser raro.
const n = "hello" as unknown as number;
// n is typed number but is actually a string
console.log(typeof n); // "string"satisfies Nunca Mente Sobre os Valores
Ao contrário de as, satisfies não pode ser usado para declarar um tipo incompatível. Ele apenas confirma que o valor já é compatível.
// const x = "hello" satisfies number; // Error: string not assignable to number
const y = 42 satisfies number;
console.log(y);as Perde as Verificações de Propriedades Excedentes
Com as, chaves extras ou escritas incorretamente passam despercebidas. satisfies ainda as sinaliza, detectando erros de digitação.
type Config = { mode: string };
const withAs = { mdoe: "dark" } as Config; // typo passes silently
// const withSat = { mdoe: "dark" } satisfies Config; // Error: mdoe
console.log(JSON.stringify(withAs));Quando as É Necessário de Forma Legítima
as tem usos válidos, como estreitar unknown depois de uma verificação em tempo de execução ou trabalhar com o DOM. Mas, para objetos de configuração, prefira satisfies.
const data: unknown = JSON.parse("{ }");
// After your own runtime validation, as can express the result.
const obj = data as Record<string, unknown>;
console.log(typeof obj);Preferindo satisfies para Configuração
Para configurações, mapas de rotas e paletas, satisfies oferece validação e inferência precisa. as não oferece validação nem garantia.
type Palette = Record<string, string>;
const safe = { primary: "blue", accent: "gold" } satisfies Palette;
console.log(safe.primary);as const É Diferente
Não confunda as const com uma asserção de tipo. as const estreita para literais e torna os elementos somente leitura; é seguro e costuma ser combinado com satisfies.
type Nums = readonly number[];
const xs = [1, 2, 3] as const satisfies Nums;
console.log(xs[0]);Resumo dos Riscos
as: substitui o compilador, não faz verificações e pode ocultar erros. satisfies: coopera com o compilador, faz uma verificação completa e preserva a inferência. Escolha satisfies por padrão.
type Config = { level: number };
// const risky = {} as Config; // compiles, level is undefined
const safe = { level: 1 } satisfies Config;
console.log(safe.level);Refatorando as para satisfies
Um bom hábito: quando encontrar as SomeObjectType em um literal que você controla, tente trocá-lo por satisfies e corrija os erros que aparecerem.
type Config = { url: string; retries: number };
// Before: const c = { url: "/api" } as Config;
const c = { url: "/api", retries: 3 } satisfies Config;
console.log(c.url, c.retries);Verificação Rápida: satisfies vs as
Teste sua compreensão de satisfies em comparação com as.
Recapitulação: satisfies vs Asserção as
Você aprendeu que as ignora verificações e pode ocultar erros, enquanto satisfies valida o valor e mantém a inferência precisa. Prefira satisfies para objetos de configuração que você controla.
type Config = { color: string; size: number };
const c = { color: "red", size: 10 } satisfies Config;
console.log(c.color, c.size);Perguntas Frequentes
A aula “satisfies versus Asserção as” é grátis?
Sim — o texto completo de “satisfies versus Asserção as” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 4 aulas no total.
O que vou aprender em “satisfies versus Asserção as”?
Entenda por que satisfies é mais seguro do que converter tipos com as. Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar TypeScript Academy?
Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “satisfies versus Asserção as”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de TypeScript Academy?
Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Por que satisfies Existe
- satisfies versus Anotação de Tipo
- satisfies versus Asserção as
- Padrões Práticos com satisfies