CKTIS / JavaScript
Carga de módulos y división del código
Los módulos forman un grafo de dependencias. Un import estático declara una dependencia, mientras que `import()` permite que el código solicite un módulo durante la ejecución. La división del código en partes que se cargan por separado depende del entorno y de las herramientas, no solo de la sintaxis de JavaScript.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
// module.mjs
export const name = value;
// main.mjs
import { name } from "./module.mjs";
async function main() {
const namespace = await import("./module.mjs");
}
main().catch(console.error);La carga de módulos consiste en obtener un módulo y sus dependencias, vincular los imports con los exports y ejecutar el código. Las declaraciones estáticas import aparecen en el nivel superior del módulo; identifican las dependencias antes de que se ejecute el cuerpo del módulo. Los nombres importados son vinculaciones vivas con los exports, no copias de sus valores.
El import(specifier) dinámico es una expresión disponible también en scripts normales y dentro de condiciones o funciones. Devuelve una Promise que normalmente se cumple con el objeto de espacio de nombres del módulo que contiene los exports una vez completadas correctamente la carga, la vinculación y la ejecución. Sin embargo, si el módulo exporta un valor invocable con el nombre then, el mecanismo de resolución de la promesa lo invoca con las funciones de resolución y rechazo. El resultado de la promesa depende entonces de esa llamada, por lo que no tiene por qué cumplirse con el objeto de espacio de nombres. Gestiona el rechazo con try/catch alrededor de await o con .catch(). Su argumento puede calcularse durante la ejecución.
La división del código consiste en preparar partes de una aplicación que se puedan cargar por separado. import() ofrece un punto de carga bajo demanda, pero ECMAScript no exige archivos de salida separados ni solicitudes de red. La resolución de especificadores y la obtención de módulos dependen del host; la división de los archivos de salida depende de las herramientas. Volver a importar el mismo módulo resuelto no vuelve a ejecutar su código. Si no hay ningún export invocable llamado then, ambos imports dinámicos, si tienen éxito, proporcionan el mismo objeto de espacio de nombres.
Los módulos estáticos se introdujeron en ES2015, y import() en ES2020. Esto no es una tabla de compatibilidad de navegadores: la especificación del lenguaje no garantiza la compatibilidad con un navegador concreto, y Node 24 no demuestra la compatibilidad con Web APIs. En el ejemplo, main.mjs es el punto de entrada y ambas llamadas a import() solicitan el mismo módulo local, math.mjs. Solo ese módulo se carga dinámicamente. El ejemplo no muestra una división del código generada por un bundler.
Ejemplos
// math.mjs
export const double = value => value * 2;
// main.mjs
async function main() {
const first = await import("./math.mjs");
const second = await import("./math.mjs");
console.log(first.double(21));
console.log(first === second);
}
main().catch(console.error);Resultado
42 true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.