ExpertiDict

TypeScript · Avançado · Inglês · Técnico

global augmentation

/ˈɡloʊbəl ˌɔɡmɛnˈteɪʃən/substantivo

Bloco declare global dentro de um módulo, que adiciona ou amplia declarações no escopo global, como propriedades de Window, variáveis globais ou namespaces de bibliotecas.

Onde usar

Usado para tipar algo injetado fora do código, como window.analytics, ou para estender o Express.Request. Costuma ficar num .d.ts ou num arquivo com export {}.

Em código

export {};
declare global {
  interface Window {
    analytics: { track(e: string): void };
  }
}
window.analytics.track('visita');

Exemplos

Add window.analytics with a global augmentation.

Adicione window.analytics com uma global augmentation.

Add export {} so the file counts as a module.

Adicione export {} para o arquivo contar como módulo.

Cuidado

Só funciona dentro de um arquivo que seja módulo; num script sem import ou export você já está no escopo global, e o declare global dá erro.

Sinônimos

declare global

Veja também

Todos os termos de TypeScript