Declarações ambientais (.d.ts) e tipagens de terceiros
Escreva declarações ambientais em arquivos .d.ts para descrever globais e módulos; instale e use tipagens de terceiros com segurança.
Declarações ambientais (.d.ts) e tipagens de terceiros é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 2 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 3 aulas no total.
Introdução
Objetivo: descrever JavaScript externo com declarações ambientais em arquivos .d.ts e usar tipagens de terceiros para bibliotecas que não têm tipos.
Declarações globais
globals.d.ts: declare globais e estenda interfaces ambientais, como Window, sem emitir JS.
// file: globals.d.ts
// Declare global variables and interfaces
declare const VERSION: string;
declare interface Window {
appReady?: boolean;
}Fundamentos de lambda com receptor
- Receptor = a instância do construtor usada dentro da lambda.
- Chamadas mais limpas: item("Tea") em vez de builder.item.
- Mantenha os nomes curtos e as ações claras.
Declarações de módulos
declare module descreve um pacote que não fornece tipagens. Agora import { coolify } passa pela verificação de tipos corretamente.
// file: cool-lib.d.ts
// Provide types for an untyped JS module
declare module "cool-lib" {
export function coolify(s: string): string;
export const version: string;
}Extensão de módulos
Extensão de módulos amplia as tipagens instaladas; por exemplo, use add para adicionar uma propriedade personalizada a uma interface existente.
// file: react-augment.d.ts
// Extend an existing module (augmentation)
declare module "react" {
interface HTMLAttributes<T> {
dataTestId?: string;
}
}Tipagens de terceiros
Prefira pacotes @types/ do DefinitelyTyped quando uma biblioteca não fornecer tipos. Eles adicionam apenas arquivos .d.ts à sua compilação.
// install: npm i -D @types/lodash
// usage:
import _ from "lodash";
const r = _.chunk([1,2,3,4], 2);Dicas e resolução
Dicas:
- Coloque seus arquivos .d.ts em src/ ou inclua-os por meio de tsconfig.json (
include/typeRoots/types). - Use a extensão de módulos para ampliar tipagens; evite editar node_modules.
- Evite um
anyabrangente demais; especifique estruturas mínimas e precisas.
Verificação das declarações ambientais
Verificação rápida: para que serve uma declaração ambiental?
Recapitulação
Recapitulação: use arquivos .d.ts para globais e módulos, prefira @types para tipagens da comunidade e amplie com segurança usando a extensão de módulos.
Recapitulação
Recapitulação: use receptores tipados por bloco, adicione @DslMarker para garantir a segurança de escopo e retorne um modelo imutável para uma utilização clara.
Aprenda TypeScript com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 101
- Aulas
- 352
Perguntas Frequentes
A aula “Declarações ambientais (.d.ts) e tipagens de terceiros” é grátis?
Sim — o texto completo de “Declarações ambientais (.d.ts) e tipagens de terceiros” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 3 aulas no total.
O que vou aprender em “Declarações ambientais (.d.ts) e tipagens de terceiros”?
Escreva declarações ambientais em arquivos .d.ts para descrever globais e módulos; instale e use tipagens de terceiros com segurança. Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar TypeScript Academy?
Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 3.
Quanto tempo leva a aula “Declarações ambientais (.d.ts) e tipagens de terceiros”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de TypeScript Academy?
Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Módulos ES (nomeados versus padrão), reexportações
- Declarações ambientais (.d.ts) e tipagens de terceiros
- Mapeamento de caminhos e resolução de módulos