TypeScript · Intermediário · Inglês · Técnico
ambient declaration
Declaração com a palavra declare que informa ao compilador a existência de um valor, função, classe ou módulo que não está no código, sem gerar JavaScript nenhum.
Onde usar
Serve para tipar variáveis globais injetadas por scripts externos ou pelo bundler, como __VERSAO__. Dentro de um .d.ts, toda declaração de topo é implicitamente ambient.
Em código
declare const __VERSAO__: string;
declare function gtag(...a: unknown[]): void;
const v: string = __VERSAO__;Exemplos
Add an ambient declaration for the global the bundler injects.
Adicione uma ambient declaration para a global que o bundler injeta.
The compiler trusts declare, so make sure the value exists.
O compilador confia no declare, então garanta que o valor exista.
Cuidado
O declare só promete: se o valor não existir em runtime, o código quebra com ReferenceError e o compilador não avisa.
Sinônimos
declare