CKTIS / JavaScript
import — importar módulos de JavaScript
La palabra clave import permite acceder a las exportaciones de otros módulos. Aprende cómo funcionan las declaraciones estáticas y los enlaces vivos, y en qué se diferencian import(...), import.meta y las llamadas a funciones ordinarias.
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
import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.metaimport es una palabra clave reservada: no puede usarse como nombre de variable. Una declaración estática import solo aparece en el nivel superior de un módulo, no dentro de una función ni de un bloque. El especificador del módulo debe ser un literal de cadena. Los imports estáticos forman parte del sistema de módulos introducido en ECMAScript 2015.
Un import predeterminado selecciona la exportación default; un import con nombre selecciona una exportación concreta, y as le asigna un nombre local. La forma import * as namespace crea un enlace local al objeto de espacio de nombres del módulo. import "module" ejecuta la dependencia sin crear enlaces locales. Los enlaces importados están vivos: reflejan los cambios realizados en el módulo que exporta. El módulo que importa no puede asignarles un valor nuevo; eso no significa que un objeto importado esté congelado.
import(specifier) es una sintaxis independiente de importación dinámica, introducida en ECMAScript 2020, no una función ordinaria. Puede aparecer en expresiones, también en un script normal, y devuelve una Promise. Tras cargar y evaluar el módulo correctamente, la promesa normalmente se cumple con el objeto de espacio de nombres del módulo. Sin embargo, si el módulo tiene una exportación invocable llamada then, el mecanismo de resolución de la promesa la invoca. La promesa puede entonces cumplirse con otro valor o rechazarse, aunque el módulo se haya evaluado correctamente. import.meta, también de ECMAScript 2020, expone metadatos del módulo que dependen del entorno anfitrión y solo se permite en módulos.
La resolución de especificadores y la carga de módulos dependen del entorno anfitrión. Ni la especificación del lenguaje por sí sola ni una ejecución correcta en Node.js demuestran que haya compatibilidad en un navegador concreto. El ejemplo muestra un enlace vivo: al llamar a increase(), cambia el valor observado mediante count.
Ejemplos
// counter.mjs
export let count = 1;
export function increment() {
count += 1;
}
// main.mjs
import { count, increment as increase } from "./counter.mjs";
console.log(count);
increase();
console.log(count);Resultado
1 2
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.