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 usar mate.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 el package.json del 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"));