Saltar al contenido
Herramientas y ecosistema

npm, pnpm y dependencias

Lección 1 de 611 min3 ejercicios

Casi ningún proyecto se escribe desde cero: se apoya en paquetes que otras personas publicaron, y esos paquetes en otros. npm es el registro donde viven (más de tres millones) y la herramienta que los instala. Entender cómo funciona te ahorra horas de "en mi computadora sí andaba".

El package.json

Todo proyecto de JavaScript tiene un package.json en su raíz. Se crea con npm init -y y describe el proyecto:

{
  "name": "tienda",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "test": "vitest",
    "lint": "eslint ."
  },
  "dependencies": {
    "hono": "^4.7.0"
  },
  "devDependencies": {
    "vite": "^7.0.0",
    "vitest": "^3.2.0"
  },
  "engines": { "node": ">=22" }
}
  • dependencies: lo que el programa necesita para funcionar.
  • devDependencies: lo que solo se usa para desarrollar (pruebas, empaquetador, linter).
  • scripts: comandos con nombre; se ejecutan con npm run dev, npm test…

Instalar y actualizar

npm install hono            # agrega a dependencies
npm install -D vitest       # agrega a devDependencies
npm install                 # instala todo lo que dice el package.json
npm ci                      # instala EXACTAMENTE lo del lockfile (para integración continua)
npm uninstall hono
npm outdated                # qué tiene versiones nuevas
npm update                  # actualiza dentro de los rangos permitidos

Todo se instala en la carpeta node_modules, que nunca se sube al repositorio (va en el .gitignore).

Versionado semántico

Las versiones tienen tres números: MAYOR.MENOR.PARCHE.

  • Parche (1.4.3): corrige errores, sin cambios en la API.
  • Menor (1.5.0): agrega funciones, sin romper lo existente.
  • Mayor (2.0.0): puede romper cosas.

Los rangos del package.json dicen qué versiones aceptas:

Rango Acepta
"1.4.2" Solo esa
"~1.4.2" Parches: 1.4.x desde 1.4.2
"^1.4.2" Menores y parches: 1.x.y desde 1.4.2 (el de por defecto)
"*" o "latest" Cualquiera (evítalo)

El lockfile

Con rangos, dos personas que instalan en días distintos pueden recibir versiones distintas. El lockfile (package-lock.json, pnpm-lock.yaml, bun.lock) guarda la versión exacta de cada paquete del árbol entero, dependencias de dependencias incluidas. Súbelo al repositorio: así todos, y el servidor, instalan lo mismo.

npx

npx ejecuta el programa de un paquete sin instalarlo de forma global:

npx eslint .                          # usa el de node_modules, o lo descarga
npx create-vite@latest mi-proyecto    # crea un proyecto nuevo

Otros gestores

  • pnpm: guarda cada versión de cada paquete una sola vez en el disco y la enlaza en cada proyecto: instala rápido y ocupa mucho menos. Es más estricto: no deja usar paquetes que no declaraste.
  • Yarn: el primer competidor de npm; muchas de sus ideas, como el lockfile, se adoptaron después en npm.
  • Bun: su bun install es el más rápido.

Con Corepack o el campo packageManager del package.json, el proyecto fija qué gestor y qué versión se usa.

Resumen

  • El package.json describe el proyecto: dependencias, devDependencies, scripts y requisitos.
  • Versionado semántico MAYOR.MENOR.PARCHE; ^ acepta menores y parches, ~ solo parches.
  • El lockfile fija las versiones exactas de todo el árbol: súbelo al repositorio; en integración continua, npm ci.
  • npx ejecuta paquetes sin instalarlos; pnpm y Bun son alternativas más rápidas.
  • Cada dependencia es código ajeno con tus permisos: elige con cuidado.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Paquetes y versiones

Elige una respuesta en cada pregunta.

  1. ¿Qué permite el rango "^1.4.2" en un package.json?

  2. ¿Para qué sirve el lockfile (package-lock.json, pnpm-lock.yaml)?

  3. ¿Qué va en devDependencies?

  4. ¿Qué ventaja principal tiene pnpm sobre npm?

Ordena la salida: Qué versiones cumplen

Un verificador de rangos de versiones simplificado. Ordena lo que aparecería en la consola.

// Un verificador de rangos simplificado (el real es el paquete "semver")function cumple(version, rango) {  const [ma, mi, pa] = version.split(".").map(Number);  const [rma, rmi, rpa] = rango.slice(1).split(".").map(Number);  if (rango[0] === "^") return ma === rma && (mi > rmi || (mi === rmi && pa >= rpa));  if (rango[0] === "~") return ma === rma && mi === rmi && pa >= rpa;  return version === rango;} console.log(cumple("1.9.0", "^1.4.2"));console.log(cumple("2.0.0", "^1.4.2"));console.log(cumple("1.4.9", "~1.4.2"), cumple("1.5.0", "~1.4.2"));console.log(["1.4.2", "1.10.0", "1.9.3"].filter((v) => cumple(v, "^1.4.2")).length);

Consola, de arriba abajo

  1. true false
  2. true
  3. 3
  4. false

Detective: Un árbol de dependencias imposible

Después de actualizar React, npm install se niega a instalar. Encuentra la línea del package.json que causa el conflicto y elige qué hacer.

Consola

npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: tienda@1.0.0
npm error Found: react@19.1.0
npm error node_modules/react
npm error   react@"^19.1.0" from the root project
npm error
npm error Could not resolve dependency:
npm error peer react@"^18.0.0" from mi-calendario@2.3.1
npm error node_modules/mi-calendario
npm error   mi-calendario@"^2.3.1" from the root project

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

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