Un programa, muchos archivos
Cuando un programa crece, tenerlo todo en un archivo se vuelve inmanejable. Los módulos permiten dividir el código en archivos, cada uno con una responsabilidad, y conectar unos con otros de forma explícita.
Cada módulo tiene su propio ámbito: sus variables y funciones no se mezclan con las de otros archivos. Solo lo que un módulo exporta puede usarse desde otro, y solo si ese otro lo importa.
Exportar con nombre
Pon export delante de lo que quieras compartir:
// matematicas.js
export const PI = 3.14159;
export function areaCirculo(radio) {
return PI * radio ** 2;
}
function ayudante() {
// no se exporta: es privada de este módulo
}
También puedes exportar al final, en una lista:
const sumar = (a, b) => a + b;
const restar = (a, b) => a - b;
export { sumar, restar };
Importar con nombre
En otro archivo, importa entre llaves lo que necesitas, usando el mismo nombre con el que se exportó:
// app.js
import { areaCirculo, PI } from "./matematicas.js";
console.log(areaCirculo(2));
- La ruta empieza con
./(misma carpeta) o../(carpeta superior). - En el navegador y en Node con módulos nativos, escribe la extensión
.js. - Puedes renombrar al importar:
import { sumar as add } from "./operaciones.js";. - O importar todo como un objeto:
import * as mate from "./matematicas.js";y usarmate.PI.
Export por defecto
Un módulo puede tener un export por defecto, normalmente su contenido principal:
// Usuario.js
export default class Usuario {
constructor(nombre) {
this.nombre = nombre;
}
}
Se importa sin llaves y con el nombre que elijas:
import Usuario from "./Usuario.js";
const u = new Usuario("Inés");
Puedes combinar ambos tipos en un mismo import: import React, { useState } from "react";.
| Con nombre | Por defecto | |
|---|---|---|
| Cuántos por módulo | Los que quieras | Uno |
| Exportar | export function f() {} |
export default function f() {} |
| Importar | import { f } from "./m.js" |
import f from "./m.js" |
| Nombre al importar | El mismo (o con as) |
El que quieras |
Importar paquetes
Los paquetes instalados con npm se importan por su nombre, sin ./:
import { format } from "date-fns";
El entorno (Node.js o la herramienta de compilación, como Vite) sabe buscarlos en la carpeta node_modules.
Usar módulos en el navegador
Agrega type="module" a la etiqueta script:
<script type="module" src="./app.js"></script>
Los módulos se cargan en modo estricto y no exponen sus variables como globales. Para probarlos necesitas abrir la página desde un servidor local (por ejemplo, la extensión Live Server de VS Code o npx serve), porque los navegadores bloquean los módulos abiertos directamente como archivo.
Usar módulos en Node.js
Node.js entiende módulos de dos formas:
- Nombrando los archivos con la extensión
.mjs. - O agregando
"type": "module"en elpackage.jsondel proyecto.
Pruébalo: crea una carpeta con estos dos archivos y ejecuta node app.mjs.
// saludos.mjs
export const saludar = (nombre) => `Hola, ${nombre}`;
// app.mjs
import { saludar } from "./saludos.mjs";
console.log(saludar("mundo"));