Mezcla de CommonJS y Módulos ES

Al trabajar en proyectos de Node.js, es posible encontrar tanto CommonJS como ES Modules en la misma base de código. Node.js utilizaba originalmente CommonJS (require/module.exports), pero ahora también admite ES Modules (import/export). Mezclar estos dos sistemas puede ser complicado debido a las diferencias en la sintaxis, las extensiones de archivo y el comportamiento de carga. Surgen problemas de compatibilidad porque no todas las funciones están disponibles al importar un tipo de módulo en otro. Es importante comprender las estrategias para utilizar ambos sistemas juntos, así como las limitaciones que pueden presentarse.

Una estrategia común consiste en elegir un sistema de módulos principal para el proyecto y utilizar funciones de compatibilidad solo cuando sea necesario. Por ejemplo, se puede mantener la mayor parte del código en CommonJS para asegurar compatibilidad con herramientas antiguas, pero emplear ES Modules para código más reciente o cuando se requieren características como import.meta.url. Node.js permite especificar el tipo de módulo en el archivo package.json mediante el campo "type": "commonjs" o "module". Los archivos con extensión .cjs siempre se tratan como CommonJS, mientras que los archivos .mjs siempre son ES Modules, independientemente del campo "type". Esto proporciona flexibilidad para mezclar tipos de módulos dentro de un proyecto, pero es importante conocer las limitaciones y diferencias en la forma en que los módulos se cargan y ejecutan.

El ejemplo de código muestra cómo se puede utilizar un módulo CommonJS dentro de un ES Module en Node.js. El archivo math.cjs utiliza la sintaxis de CommonJS, exportando una función add con module.exports.add = (a, b) => a + b;. Esta función suma dos números y devuelve el resultado.

El archivo app.mjs es un ES Module. Los ES Modules no pueden usar require directamente, por lo que se importa la función createRequire del paquete integrado module. Al llamar a createRequire(import.meta.url), se crea una función require que funciona en el contexto del archivo ES Module actual. Luego, se utiliza este require para importar el módulo CommonJS (math.cjs).

Cuando se llama a math.add(2, 3), el código muestra 5 en la consola. Este enfoque permite mezclar CommonJS y ES Modules en el mismo proyecto, aprovechando las ventajas de cada sistema según sea necesario.