as Asserções de tipo (incluindo asserções duplas)
Última atualização: 2026-10-22
as Asserções de tipo (incluindo asserções duplas)
Uma asserção de tipo (as) diz ao compilador "eu conheço o tipo deste valor melhor do que você — trate-o como T". Ela nunca altera o valor em tempo de execução nem realiza conversão; simplesmente sobrepõe a inferência. Use-a quando você detém informações que o compilador não consegue obter (consultas ao DOM, valores unknown de terceiros), sabendo que uma asserção errada não é conferida.
| Grupo | Restrição e Asserções de Tipos |
|---|---|
| Tipo | Operador |
| Modo strict | Não necessário |
ℹ️ Info O editor transpila TypeScript para JavaScript e o executa (sem verificação de tipos); veja a Saída de cada exemplo para o resultado da verificação.
📝 Sintaxe
const el = document.getElementById("root") as HTMLElement;
const data = JSON.parse(raw) as Config; // comum: colapsa unknown/any para um tipo concreto
// quando dois tipos não compartilham nada, é necessária uma asserção dupla (code smell)
const n = value as unknown as Config;⚙️ Parâmetros
| as T | Faz a asserção da expressão como T. O TS só permite asserções entre tipos "sobrepostos" (um atribuível ao outro); caso contrário, acusa erro |
|---|---|
| as unknown as T | Asserção dupla: passa primeiro por unknown e depois para T, contornando a verificação de sobreposição. Quase sempre é sinal de um problema de modelagem |
Retorno：Asserções não emitem código em tempo de execução — o resultado transpilado é idêntico sem o as; apenas a visão de tipos em tempo de compilação muda.
▶ Exemplo
Edite o código abaixo e clique em Testar para ver o resultado transpilado:
Saída：
20 dark
string
(Saída de execução após a transpilação. Note a segunda linha: após a asserção para {w:number}, o valor em tempo de execução ainda é a string "1920x1080" — asserções não transformam valores, typeof legacy é "string". Uma asserção errada só aparece em tempo de execução)💡 Observações
🏷️ Restrição e Asserções de Tipos Relacionadas
💡 Casos relacionados
📚 Tutoriais relacionados
❓ Perguntas frequentes
