export e import
Un módulo es un archivo. Lo que no se exporta es privado:
// matematicas.js
const PI_APROX = 3.14; // privado: nadie más lo ve
export function areaCirculo(r) { // exportación con nombre
return PI_APROX * r * r;
}
export const nombre = "matemáticas";
export default function sumar(a, b) { // exportación por defecto (una por módulo)
return a + b;
}
// main.js
import sumar, { areaCirculo, nombre as modulo } from "./matematicas.js";
import * as mat from "./matematicas.js"; // todo, como un objeto
console.log(sumar(2, 3));
console.log(areaCirculo(2), modulo);
console.log(mat.nombre);
- Las exportaciones con nombre se importan entre llaves, con el mismo nombre (o renombradas con
as). - La exportación por defecto se importa sin llaves, con el nombre que elijas.
- Muchos equipos prefieren usar solo exportaciones con nombre: el nombre es el mismo en todo el proyecto y los editores lo autocompletan mejor.
Cómo se carga un módulo
- Se leen todos los
importantes de ejecutar nada: por eso solo pueden ir en el nivel superior. - Se cargan las dependencias, y las dependencias de las dependencias.
- Se evalúan de las hojas a la raíz: un módulo corre después de todo lo que importa.
- Cada módulo se evalúa una sola vez, aunque lo importen cien archivos.
Además, todo módulo corre en modo estricto, tiene su propio scope (sus variables no son globales) y su this en el nivel superior es undefined.
Enlaces vivos
Lo que importas no es una copia, sino un enlace a la variable del otro módulo. Si el módulo la cambia, lo ves:
// contador.js
export let cuenta = 0;
export function sumar() { cuenta++; }
// main.js
import { cuenta, sumar } from "./contador.js";
sumar();
console.log(cuenta); // 1: es la misma variable
// cuenta = 5; // TypeError: los imports son de solo lectura
import() dinámico
import(ruta) carga un módulo cuando hace falta y devuelve una promesa. Sirve para no cargar al principio código pesado que quizá nunca se use:
botonGrafico.addEventListener("click", async () => {
const { dibujarGrafico } = await import("./grafico-pesado.js");
dibujarGrafico(datos);
});
La ruta puede calcularse en el momento, por ejemplo con el idioma del usuario:
const textos = await import(`./idiomas/${idioma}.js`);
import.meta
import.meta tiene información sobre el módulo actual:
console.log(import.meta.url); // la URL de este archivo
console.log(import.meta.resolve("./datos.json")); // la URL de otro, relativa a este
// En Node.js, además:
console.log(import.meta.dirname, import.meta.filename);
Resumen
exportmuestra lo que el módulo ofrece; lo demás es privado.- Exportaciones con nombre (
{ x }) y por defecto (una por módulo). - Los
importse resuelven antes de ejecutar; las dependencias se evalúan primero, una sola vez. - Los imports son enlaces vivos y de solo lectura.
import()carga módulos bajo demanda y devuelve una promesa;import.metadescribe el módulo actual.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: import y export
Resuelto
Elige una respuesta en cada pregunta.
¿Qué diferencia hay entre
export const xyexport default x?Si dos archivos importan el mismo módulo, ¿cuántas veces se ejecuta su código?
¿Qué devuelve
import("./grafico.js")?El código de un módulo, ¿corre en modo estricto?
Ordena la salida: Quién se evalúa primero
Resuelto
Tres archivos que se importan en cadena. Al ejecutar node main.js, ¿en qué orden aparecería cada línea?
1// main.js2import { saludo } from "./a.js";3console.log("main:", saludo);4 5// a.js6import "./b.js";7console.log("evaluando a");8export const saludo = "hola";9 10// b.js11console.log("evaluando b");Consola, de arriba abajo
- main: hola
- evaluando b
- evaluando a
Antes de ejecutar un módulo, se ejecutan sus dependencias, en profundidad. main necesita a a, y a necesita a b: el orden es b, a, main. Todos los import se resuelven antes de la primera línea de código.
Detective: Un import en un script clásico
Resuelto
El navegador se niega a ejecutar el archivo. Encuentra la línea culpable y elige el arreglo.
Consola
Uncaught SyntaxError: Cannot use import statement outside a module (at app.js:1:1)
Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?