0Pricing
TypeScript Academy · Lección

Namespaces frente a módulos: uso moderno

Comprenda por qué se prefieren los módulos a los namespaces.

Namespaces frente a módulos: uso moderno es una lección gratuita de TypeScript Academy en CoddyKit. Esta es la lección 4 de 4. 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 4 lecciones en total.

Bienvenida

TypeScript originalmente tenía espacios de nombres (antes llamados «módulos internos») para organizar el código. El TypeScript moderno utiliza módulos ES en su lugar. En esta lección se explica cuándo es apropiado usar cada uno.

Qué es un espacio de nombres

Un espacio de nombres es una forma específica de TypeScript de agrupar código relacionado dentro de un ámbito con nombre mediante la palabra clave `namespace`.
namespace Geometry {
  export interface Point { x: number; y: number; }
  export function distance(a: Point, b: Point): number {
    return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
  }
}

Acceso a los miembros de un espacio de nombres

Acceda a los miembros de un espacio de nombres mediante el nombre del espacio de nombres y la notación de punto.
const p1: Geometry.Point = { x: 0, y: 0 };
const p2: Geometry.Point = { x: 3, y: 4 };
const d = Geometry.distance(p1, p2); // 5

Espacios de nombres anidados

Los espacios de nombres pueden anidarse.
namespace App {
  export namespace Models {
    export interface User { name: string; }
  }
}
const u: App.Models.User = { name: 'Alice' };

Fusión de espacios de nombres

Los espacios de nombres admiten la fusión de declaraciones: dos declaraciones de espacio de nombres con el mismo nombre se fusionan.
namespace Validation {
  export function validate(s: string): boolean { return s.length > 0; }
}
namespace Validation {
  export function sanitize(s: string): string { return s.trim(); }
}

Por qué se prefieren los módulos

Los módulos ES son el estándar de JavaScript. Todos los empaquetadores los admiten, permiten una eliminación de código no utilizado eficiente y funcionan de forma nativa en los navegadores modernos y Node.js.

El equivalente modular de un espacio de nombres

En TypeScript moderno, un espacio de nombres se convierte simplemente en un archivo. Exporte lo que quiera hacer público y mantenga el resto privado.
// geometry.ts
export interface Point { x: number; y: number; }
export function distance(a: Point, b: Point): number {
  return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
}

Los espacios de nombres aún se usan en archivos de declaración

Los espacios de nombres todavía se utilizan ampliamente en archivos de declaración .d.ts para bibliotecas globales (como los tipos del DOM y de Node.js), porque amplían el ámbito global.
// node.d.ts
declare namespace NodeJS {
  interface ProcessEnv { NODE_ENV?: 'development' | 'production'; }
}

Referencias de triple barra (heredadas)

Antes de los módulos ES, las directivas de triple barra hacían referencia a otros archivos. Hoy, `tsconfig` includes y las importaciones de módulos las reemplazan.
/// <reference types="node" />
/// <reference path="./other.d.ts" />

Cuándo seguir usando espacios de nombres

Use espacios de nombres: (1) en archivos de declaración para tipos globales ambientales y (2) al ampliar espacios de nombres globales existentes de bibliotecas.

Migración de espacios de nombres a módulos

Reemplace `namespace Foo {}` por un archivo de módulo. Reemplace `/// ` por importaciones. El equipo de TypeScript documentó esta ruta de migración.

Comprobación rápida

En TypeScript moderno, ¿cuál es el reemplazo recomendado para los espacios de nombres?

Recapitulación

Los espacios de nombres organizan el código dentro de un ámbito con nombre, pero son una característica heredada en el TypeScript moderno. Use módulos ES (import/export) para el código de la aplicación. Los espacios de nombres siguen siendo útiles en archivos de declaración para ampliar tipos globales.

Preguntas frecuentes

¿La lección «Namespaces frente a módulos: uso moderno» es gratis?

Sí — el texto completo de «Namespaces frente a módulos: uso moderno» 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 4 lecciones en total.

¿Qué aprenderé en «Namespaces frente a módulos: uso moderno»?

Comprenda por qué se prefieren los módulos a los namespaces. 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 4 de 4.

¿Cuánto tiempo toma la lección «Namespaces frente a módulos: uso moderno»?

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. Sintaxis de módulos ES: import y export
  2. Reexportaciones y archivos barrel
  3. Importaciones y exportaciones solo de tipos
  4. Namespaces frente a módulos: uso moderno
← Volver a TypeScript Academy