0Pricing
TypeScript Academy · Lección

Fundamentos de .d.ts; export type frente a export

Conozca los fundamentos de los archivos de declaración: declaraciones ambientales frente a declaraciones de módulo, export type frente a export, y cómo garantizar una experiencia de desarrollo correcta para los consumidores.

Fundamentos de .d.ts; export type frente a export es una lección gratuita de TypeScript Academy en CoddyKit. Esta es la lección 1 de 2. 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 2 lecciones en total.

Introducción

Objetivo: Escribir archivos .d.ts útiles. Aprenderá las declaraciones ambientales y de módulo, cómo declarar exports y cuándo utilizar export type frente a export.

  • Contexto ambiental frente a contexto de módulo
  • Exports solo de tipos frente a exports de valores
  • Buenas prácticas

Declaraciones ambientales

Utilice declare global para ampliar el ámbito global. Añada export {} para marcar el archivo como módulo y evitar conflictos.

// globals.d.ts
// Ambient declaration: no import/export, augments global scope
declare global {
  interface Window {
    APP_VERSION: string
  }
}

export {} // ensures this file is a module

Declaraciones de módulo

declare module describe la estructura de un paquete externo. Utilice exports en su interior para reflejar lo que proporciona el JS.

// types/index.d.ts
// Declare a module with exports
declare module "mylib" {
  export function greet(name: string): string
  export const version: string
}

Export type frente a export

export type (o interface) se utiliza para construcciones que solo existen como tipos. Utilice export para funciones, constantes y clases: elementos que existen en tiempo de ejecución.

// shapes.d.ts
export type Point = { x: number; y: number }

export interface User {
  id: string
  name: string
}

export function distance(a: Point, b: Point): number
export const VERSION: string

Ampliación de módulos

Puede ampliar módulos existentes volviendo a abrirlos en otro archivo de declaración. Es útil para corregir paquetes de terceros.

// augment.d.ts
import "mylib"
declare module "mylib" {
  export function extra(): void
}

Buenas prácticas

Buenas prácticas:

  • Mantenga los archivos .d.ts mínimos; evite los globales innecesarios.
  • Separe claramente los exports que solo son tipos de los exports de valores.
  • Pruebe los archivos de declaración con tsc --noEmit y un uso de ejemplo.

Comprobación de export type

Comprobación rápida: ¿Cuándo debe utilizar export type?

Repaso

Repaso: Los archivos .d.ts declaran tipos sin implementación. Utilice declare global o declare module, separe export type de export y siga las buenas prácticas.

Preguntas frecuentes

¿La lección «Fundamentos de .d.ts; export type frente a export» es gratis?

Sí — el texto completo de «Fundamentos de .d.ts; export type frente a export» 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 2 lecciones en total.

¿Qué aprenderé en «Fundamentos de .d.ts; export type frente a export»?

Conozca los fundamentos de los archivos de declaración: declaraciones ambientales frente a declaraciones de módulo, export type frente a export, y cómo garantizar una experiencia de desarrollo correc… 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 1 de 2.

¿Cuánto tiempo toma la lección «Fundamentos de .d.ts; export type frente a export»?

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

  1. Fundamentos de .d.ts; export type frente a export
  2. Publicación de paquetes con tipos
← Volver a TypeScript Academy