ESM estable en Node.js: Soporte de require

Wed, 05 Nov 2025 00:00:00 +0900

Node.js ha estabilizado el soporte de ES Modules. La función require(esm) permite cargar módulos ESM desde CJS de forma síncrona, simplificando la migración.

require(esm) en Node.js 22+

Node.js 22+ permite require() de módulos ESM sincrónicamente si no tienen top-level await. Facilita la adopción híbrida.

Configuración

No requiere flags de línea de comandos. Los paquetes ESM deben declararse con "type": "module" o .mjs. require() resuelve automáticamente.

Limitaciones

Top-level await deshabilita require(esm). Paquetes ESM con solo named exports pueden necesitar ajustes. Los loaders personalizados afectan el comportamiento.

Interoperabilidad ESM y CJS en Node.js

Fri, 25 Jul 2025 00:00:00 +0900

Node.js soporta dos sistemas de módulos: CommonJS (require) y ES Modules (import). La interoperabilidad entre ambos tiene reglas específicas.

Detección del tipo de módulo

.mjs siempre ESM. .cjs siempre CJS. .js depende del package.json más cercano: "type": "module" para ESM, "type": "commonjs" o sin campo para CJS.

Importar CJS desde ESM

Los módulos CJS se importan con import desde ESM. Node.js envuelve module.exports como default export. Named exports requieren análisis estático limitado.