Saltar al contenido
Módulos

Organizar un proyecto

Lección 4 de 410 min3 ejercicios

Saber escribir import y export es la mitad del trabajo. La otra mitad es decidir dónde va cada cosa: qué módulos existen, qué muestra cada uno y quién depende de quién. Un proyecto bien repartido se entiende, se prueba y se cambia sin miedo.

Por funcionalidad, no por tipo

Hay dos formas comunes de repartir las carpetas:

Por tipo                          Por funcionalidad
src/                              src/
  componentes/                      carrito/
    CarritoLista.js                   CarritoLista.js
    PerfilTarjeta.js                  carrito.js        (la lógica)
  servicios/                          carrito.test.js
    carrito.js                      perfil/
    perfil.js                         PerfilTarjeta.js
  utils/                              perfil.js
    formatearPrecio.js              compartido/
                                      formatearPrecio.js

Por tipo es cómodo al principio. Pero cuando el proyecto crece, cambiar “el carrito” obliga a saltar entre carpetas. Por funcionalidad, lo que cambia junto vive junto, y borrar una funcionalidad es borrar una carpeta.

Un módulo, una responsabilidad

Cada módulo debería tener un propósito que se explique en una frase, y exportar lo mínimo necesario. Lo que no exportas lo puedes cambiar sin romper a nadie.

// carrito/carrito.js
const items = [];                         // privado

export function agregar(producto) {       // la interfaz pública
  items.push(producto);
}

export function total() {
  return items.reduce((s, p) => s + p.precio, 0);
}

Barrel files

Un barrel es un index.js que reexporta lo de su carpeta, para importar todo desde un solo lugar:

// componentes/index.js
export { Boton } from "./boton.js";
export { Tabla } from "./tabla.js";
export * from "./formularios.js";

// en otro lado
import { Boton, Tabla } from "./componentes/index.js";

Es cómodo, pero tiene un costo: importar una cosa del barrel carga y evalúa todo lo que reexporta. En proyectos grandes, eso hace más lentos los arranques y las pruebas. Úsalos con moderación, sobre todo dentro de tu propio código.

Dependencias circulares

Si a.js importa a b.js y b.js importa a a.js, uno de los dos se evalúa primero y encuentra al otro a medio cargar, con sus constantes todavía en la zona muerta temporal. A veces funciona, a veces no, según el orden: es frágil.

La solución casi siempre es la misma: mover lo que comparten a un tercer módulo del que dependan los dos.

Efectos al importar

Un módulo que hace cosas solo por ser importado (conectarse a algo, modificar el DOM, cambiar objetos globales) es más difícil de probar y de reutilizar. Lo recomendable es que un módulo solo declare cosas, y que el trabajo empiece cuando alguien llama a sus funciones.

// Mejor: no hace nada hasta que lo llaman
export function iniciarAnaliticas(config) { /* … */ }

// Peor: se ejecuta al importarlo, quieras o no
// conectarAnaliticas();

El campo exports

Si publicas un paquete, "exports" en el package.json define exactamente qué se puede importar desde afuera. Lo que no está ahí es privado, aunque el archivo exista:

{
  "name": "mi-libreria",
  "type": "module",
  "exports": {
    ".": "./src/index.js",
    "./fechas": "./src/fechas/index.js"
  }
}

Con esto, import x from "mi-libreria/fechas" funciona, pero "mi-libreria/src/interno.js" no.

Resumen

  • Organiza por funcionalidad: lo que cambia junto, vive junto.
  • Cada módulo, una responsabilidad; exporta lo mínimo.
  • Los barrel files son cómodos, pero cargan todo lo que reexportan.
  • Evita las dependencias circulares moviendo lo compartido a un tercer módulo.
  • Los módulos deberían declarar, no actuar, al importarse.
  • "exports" decide qué es público en un paquete; "imports", los alias internos con #.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Piezas que encajan

Elige una respuesta en cada pregunta.

  1. En un proyecto mediano, ¿cuál suele escalar mejor?

  2. ¿Qué problema puede traer un barrel file (un index.js que reexporta todo)?

  3. ¿Qué es una dependencia circular?

  4. ¿Para qué sirve el campo "exports" del package.json?

Ordena la salida: Un barrel que carga de más

main.js solo quiere el botón. Al ejecutarlo, ¿en qué orden aparecería cada línea?

// componentes/index.jsexport { Boton } from "./boton.js";export { Tabla } from "./tabla.js"; // componentes/boton.jsconsole.log("cargo boton");export const Boton = "botón"; // componentes/tabla.jsconsole.log("cargo tabla (pesada)");export const Tabla = "tabla"; // main.jsimport { Boton } from "./componentes/index.js";console.log("uso", Boton);

Consola, de arriba abajo

  1. cargo tabla (pesada)
  2. uso botón
  3. cargo boton

Detective: Una dependencia circular

Dos módulos que se necesitan mutuamente. Encuentra la línea que falla y elige la mejor solución.

Consola

file:///proyecto/impuestos.js:3
export const minimo = PRECIO_BASE * IVA;
                      ^

ReferenceError: Cannot access 'PRECIO_BASE' before initialization

Paso 1: toca la línea de código que causa el error.

domina-js · JavaScript en español, gratis y paso a paso.