TypeScript · Intermediário · Inglês · Técnico
declaration emit
Opção declaration que gera um arquivo .d.ts ao lado de cada .js, descrevendo os tipos públicos da biblioteca para quem a consome. Combina com declarationMap para navegar até o fonte.
Onde usar
Necessária ao publicar uma biblioteca no npm com tipos. Se o campo types do package.json aponta para um .d.ts que não existe, os consumidores perdem o autocompletar.
Em código
{
"compilerOptions": {
"declaration": true,
"declarationMap": true,
"outDir": "dist"
}
}Exemplos
Enable declaration emit so consumers get the types.
Ligue o declaration emit para os consumidores receberem os tipos.
The declaration emit failed because a type can't be named.
O declaration emit falhou porque um tipo não pode ser nomeado.
Cuidado
O .d.ts gerado reflete tipos inferidos, e exportar funções sem tipo de retorno explícito pode vazar tipos internos ou dar erro de 'cannot be named'.
Sinônimos
declaration