ExpertiDict

TypeScript · Intermediário · Português · Técnico

declaração de módulo

/deklaɾaˈsɐ̃w dʒi ˈmɔdulu/substantivo feminino

Forma declare module 'nome' que descreve o tipo de um módulo importável sem código-fonte, aceitando curingas como '*.svg' para tipar arquivos que o bundler transforma.

Onde usar

Resolve o erro de que o módulo não tem declaração ao importar imagens, CSS modules ou bibliotecas sem tipos. O arquivo com a declaração precisa entrar no programa pelo include.

Em código

// globais.d.ts (sem import/export)
declare module '*.svg' {
  const url: string;
  export default url;
}
declare module 'lib-sem-tipos';

Exemplos

Criei uma declaração de módulo para o compilador aceitar os imports de svg.

Sem a declaração de módulo, o import da imagem dá erro de tipo.

Cuidado

Se o arquivo tiver import ou export, o declare module vira um aumento de módulo; para declarar módulos novos o arquivo deve ser um script, sem imports no topo.

Sinônimos

declare module, módulo ambient

Veja também

Todos os termos de TypeScript