Declarações e fusão

Arquivos de declaração de tipo (com extensão .d.ts) são usados ​​em TypeScript para descrever a forma do código JavaScript existente sem implementar qualquer lógica real. Eles contêm apenas definições de tipo, interfaces e assinaturas de funções.

Esses arquivos são essenciais ao usar bibliotecas de terceiros escritas em JavaScript puro.

Mesclagem de declarações

Mesclagem de declarações é um comportamento em que o compilador mescla duas ou mais declarações separadas declaradas com o mesmo nome em uma única definição.

O caso mais comum é a fusão de interface:

interface User {
  name: string;
}

interface User {
  age: number;
}

// The resulting User interface has both name and age properties!
const student: User = {
  name: 'Alice',
  age: 23,
};

Se as propriedades compartilharem o mesmo nome, elas deverão ser do mesmo tipo, caso contrário, o TypeScript reportará um erro.

Modificando Módulos Globais e Externos

Podemos usar a fusão de declarações para estender interfaces definidas em outros módulos ou no escopo global.

Por exemplo, se quisermos adicionar uma propriedade ao objeto window global do navegador:

declare global {
  interface Window {
    analyticsToken: string;
  }
}

Ao usar declare global, informamos ao TypeScript que estamos injetando uma nova assinatura na interface Window global existente.

Experimente você mesmo

Exercício 1: Mesclagem de declarações básicas

Exercício 2: Estendendo a Interface da Janela Global