TypeScript · Intermediário · Português · Técnico
arquivo de declaração
Arquivo .d.ts que contém só declarações de tipos, sem implementação, descrevendo a forma de código JavaScript existente. É como o compilador conhece bibliotecas escritas em JS.
Onde usar
Aparece no campo types de pacotes npm e nos pacotes @types. Quando falta um, o erro 'Could not find a declaration file for module' obriga a instalar ou escrever um.
Em código
// contador.d.ts
export declare function contar(
xs: string[]
): number;
export interface Opcoes {
ignorar?: string[];
}Exemplos
Escrevi um arquivo de declaração para tipar a biblioteca que não tem tipos.
O .d.ts gerado pelo build vai junto no pacote npm.
Cuidado
Um .d.ts não gera nem altera JavaScript: se o tipo declarado divergir do código real, o compilador acredita no arquivo e o erro só aparece em runtime.
Sinônimos
arquivo .d.ts, declaration file