3. Sistema de Módulos: CommonJS (require/module.exports) vs ES Modules (import/export)
Domina los dos sistemas de modularización: require y module.exports clásico frente a la sintaxis moderna import/export con type: "module" en package.json.
La Convivencia de Dos Sistemas de Módulos
Cuando Node.js nació en 2009, JavaScript aún no contaba con un sistema oficial de módulos en su especificación. Node implementó CommonJS (CJS). Años más tarde, el comité ECMAScript estandarizó los ES Modules (ESM). Hoy en día, todo desarrollador profesional de Node.js debe dominar ambos enfoques y saber cuándo aplicar cada uno.
1. CommonJS (CJS): El Estándar Tradicional
CommonJS es el formato por defecto en proyectos Node que no configuran lo contrario. Sus características clave son:
- Carga Síncrona: Los módulos se cargan y evalúan dinámicamente en tiempo de ejecución mediante la función
require('modulo'). - Exportación: Se asignan propiedades al objeto
module.exports = { ... }oexports.miFuncion = .... - Variables Globales de Archivo: Incluye automáticamente
__dirname(ruta de la carpeta actual) y__filename(ruta absoluta del archivo).
2. ES Modules (ESM): El Estándar Oficial Moderno
Es la sintaxis nativa de JavaScript moderno (import y export), compartida entre navegadores y backend:
- Carga Estática Asíncrona: El motor analiza las dependencias en una fase previa antes de ejecutar el código, permitiendo optimizaciones como Tree Shaking.
- Top-Level Await: Puedes usar la palabra clave
awaitdirectamente en la raíz de un archivo sin necesidad de envolverla dentro de una funciónasync. - Rutas Obligatorias: En ESM relativo, siempre se debe especificar la extensión del archivo (ej.
import { helper } from './utils.js';).
¿Cómo Activar ES Modules en un Proyecto?
Existen dos métodos oficiales reconocidos por el runtime:
- Configuración en package.json (Recomendado): Agrega
"type": "module"en la raíz de tupackage.json. Todos los archivos.jsdel proyecto se interpretarán como ESM. - Por extensión de archivo:
.mjs: Forzado a ejecutarse como ES Module..cjs: Forzado a ejecutarse como CommonJS (muy útil para archivos de configuración comotailwind.config.cjsen proyectos ESM).
Reemplazo de __dirname en ES Modules
En ESM, __dirname y __filename no existen. Se obtienen elegantemente con import.meta.url y los módulos nativos node:url y node:path:
import { fileURLToPath } from 'node:url';
import { dirname } from 'node:path';
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
⚡ Comparativa de Código: Módulo Matemático en CommonJS vs ES Modules
Estructura de exportación e importación lado a lado entre CJS y ESM:
// =========================================================================
// ENFOQUE A: CommonJS (archivo cjs-demo.js)
// =========================================================================
// Exportación en CJS:
function sumar(a, b) { return a + b; }
function multiplicar(a, b) { return a * b; }
module.exports = { sumar, multiplicar };
// Consumo en otro archivo CJS:
// const { sumar, multiplicar } = require('./cjs-demo.js');
// console.log(sumar(10, 5)); // 15
// =========================================================================
// ENFOQUE B: ES Modules (archivo esm-demo.js con "type": "module")
// =========================================================================
// Exportación nombrada y por defecto en ESM:
export function restar(a, b) { return a - b; }
export const PI = 3.14159;
export default class Calculadora {
dividir(a, b) {
if (b === 0) throw new Error('No se puede dividir por cero');
return a / b;
}
}
// Consumo en otro archivo ESM con Top-Level Await nativo:
// import Calculadora, { restar, PI } from './esm-demo.js';
// const calc = new Calculadora();
// console.log('Resultado:', calc.dividir(20, 4)); // 5
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la forma estándar de indicar a Node.js que todos los archivos .js de un proyecto deben tratarse como ES Modules (import/export)?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.