Declaraciones ambientales (.d.ts) y tipados de terceros
Escriba declaraciones ambientales en archivos .d.ts para describir elementos globales y módulos; instale y utilice tipados de terceros de forma segura.
Declaraciones ambientales (.d.ts) y tipados de terceros es una lección gratuita de TypeScript Academy en CoddyKit. Esta es la lección 2 de 3. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de TypeScript Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de TypeScript Academy incluye 3 lecciones en total.
Introducción
Objetivo: describir JavaScript externo con declaraciones ambientales en archivos .d.ts y usar definiciones de tipos de terceros para bibliotecas que carecen de tipos.
Declaraciones globales
globals.d.ts: declare globales y amplíe interfaces ambientales (por ejemplo, Window) sin generar JS.
// file: globals.d.ts
// Declare global variables and interfaces
declare const VERSION: string;
declare interface Window {
appReady?: boolean;
}Conceptos básicos de las lambdas con receptor
- Receptor = la instancia de builder que se usa dentro de la lambda.
- Llamadas más limpias: item("Tea") en lugar de builder.item.
- Mantenga los nombres cortos y las acciones claras.
Declaraciones de módulos
declare module describe un paquete que no incluye tipos. Ahora import { coolify } se comprueba correctamente.
// 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;
}Ampliación de módulos
La ampliación de módulos extiende las definiciones de tipos instaladas; por ejemplo, permite añadir una propiedad personalizada a una interfaz existente.
// file: react-augment.d.ts
// Extend an existing module (augmentation)
declare module "react" {
interface HTMLAttributes<T> {
dataTestId?: string;
}
}Definiciones de tipos de terceros
Prefiera los paquetes @types/ de DefinitelyTyped cuando una biblioteca no incluya tipos. Solo añaden archivos .d.ts a la compilación.
// install: npm i -D @types/lodash
// usage:
import _ from "lodash";
const r = _.chunk([1,2,3,4], 2);Consejos y resolución
Consejos:
- Coloque sus archivos .d.ts bajo src/ o inclúyalos mediante tsconfig.json (
include/typeRoots/types). - Use la ampliación de módulos para extender tipos; evite editar node_modules.
- Evite un
anydemasiado amplio; especifique estructuras mínimas y precisas.
Comprobación de las declaraciones ambientales
Comprobación rápida: ¿Para qué se utiliza una declaración ambiental?
Resumen
Resumen: use archivos .d.ts para globales y módulos, prefiera @types para las definiciones de tipos de la comunidad y amplíe tipos de forma segura con la ampliación de módulos.
Resumen
Resumen: Use receptores tipados por bloque, añada @DslMarker para garantizar la seguridad del ámbito y devuelva un modelo inmutable para facilitar su uso.
Preguntas frecuentes
¿La lección «Declaraciones ambientales (.d.ts) y tipados de terceros» es gratis?
Sí — el texto completo de «Declaraciones ambientales (.d.ts) y tipados de terceros» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de TypeScript Academy, actualiza a CoddyKit PRO. El curso de TypeScript Academy incluye 3 lecciones en total.
¿Qué aprenderé en «Declaraciones ambientales (.d.ts) y tipados de terceros»?
Escriba declaraciones ambientales en archivos .d.ts para describir elementos globales y módulos; instale y utilice tipados de terceros de forma segura. Practicas TypeScript Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar TypeScript Academy?
No se requiere experiencia previa. TypeScript Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 3.
¿Cuánto tiempo toma la lección «Declaraciones ambientales (.d.ts) y tipados de terceros»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de TypeScript Academy?
Sí. Cada lección de TypeScript Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Módulos ES (con nombre frente a predeterminados) y reexportaciones
- Declaraciones ambientales (.d.ts) y tipados de terceros
- Mapeo de rutas y resolución de módulos