Teoría: Dependencias

Cuando trabajamos en proyectos reales con JavaScript, no todo lo podemos hacer solo con las funciones que ya vienen incluidas. A veces necesitamos herramientas extra. Por suerte, existe una gran comunidad que comparte soluciones reutilizables, conocidas como paquetes de terceros.

¿Qué es la biblioteca estándar?

Veamos algunos ejemplos:

// Redondear un número
Math.round(5.34); // Devuelve 5

Eso funciona tanto en el navegador como en Node.js. Pero Node.js (que usamos para ejecutar JavaScript en el servidor o en la terminal) incluye muchos más módulos útiles.

Por ejemplo:

// Usar el módulo 'fs' para leer archivos en Node.js
import fs from "fs";
// Leer el contenido de un archivo
const data = fs.readFileSync("ruta/del/archivo.txt"); // Lee el archivo completo.
console.log(data.toString()); // Mostramos el contenido

En resumen:

Sin embargo, la biblioteca estándar tiene sus límites. Entonces...

¿Por qué usar paquetes de terceros?

A veces necesitamos hacer cosas más complejas: trabajar con fechas, convertir textos, manipular arrays, enviar correos, crear PDFs… Y no queremos escribir todo desde cero.

Ejemplos de paquetes útiles

Veamos lodash en acción:

import _ from "lodash";
// Encontrar elementos comunes entre dos arreglos
console.log(_.intersection([1, 2, 3], [2, 3, 4])); // [2, 3]
// Capitalizar textos
console.log(_.capitalize("colombia")); // Colombia

💡 Una nota clave: cuando importamos paquetes así:

import _ from "lodash";

No usamos ./, porque el paquete está en una carpeta especial llamada node_modules/.

Si pusiéramos esto, estaríamos buscando un archivo llamado lodash.js en nuestra carpeta, lo cual no es lo correcto.

import _ from "./lodash.js"; // Incorrecto

¿Cómo instalamos paquetes con npm?

Si escribimos código que usa lodash sin instalarlo, veremos un error como este:

Error: Cannot find module 'lodash'

Pasos para instalar un paquete

Desde la terminal, en la carpeta del proyecto:

npm install lodash

Esto hace varias cosas:

1. Descarga el paquete y lo guarda en node_modules/.
2. Registra la dependencia en el archivo package.json.
3. Crea (o actualiza) el archivo package-lock.json.

Ahora podemos importar lodash y usarlo sin problemas:

import _ from "lodash";
console.log(_.capitalize("javascript")); // JavaScript

¿Qué hacen package.json y package-lock.json?

Estos dos archivos son responsables de llevar el control de qué paquetes usa el proyecto:

package.json

Es el archivo principal de configuración del proyecto. Allí se guardan las dependencias con sus versiones mínimas necesarias.

Cuando instalas un paquete con npm install, su nombre y versión se agregan automáticamente a package.json.

❓ ¿Por qué es útil?

• Nos asegura que si otra persona instala el proyecto, tendrá exactamente las mismas versiones.
• npm usa este archivo cuando ejecutamos:

npm ci

Esto instala exactamente lo que diga el archivo package-lock.json.

node_modules y Git

Cuando usamos Git (por ejemplo, en GitHub), tenemos que tener cuidado con los archivos que subimos.

¿Qué debe ir en Git?

Entonces, en .gitignore debemos asegurarnos de incluir:

node_modules/

Y si clonamos un proyecto de GitHub, antes de ejecutarlo debemos instalar sus dependencias con:

npm ci

Advertencias al instalar

A veces al instalar paquetes, npm muestra advertencias como esta:

npm WARN deprecated minimatch@2.0.10: Please update to minimatch 3.0.2 or higher...

❓ ¿Es grave? Normalmente no.

Si quieres actualizar los paquetes a las últimas versiones que sean compatibles con tu package.json, puedes ejecutar:

npm update