Detectar y actualizar dependencias obsoletas
Aprende a usar npm outdated para identificar dependencias desactualizadas, npm update para actualizarlas dentro del rango permitido, y estrategias para mantener tus proyectos actualizados de forma segura.
Mantener las dependencias actualizadas es crucial para la seguridad y funcionalidad de tu proyecto. Las dependencias obsoletas pueden contener vulnerabilidades conocidas, bugs que ya tienen fixes disponibles, y causar problemas de compatibilidad con otras librerías.
En esta lección vas a aprender a identificar qué paquetes están desactualizados, cómo actualizarlos correctamente dentro del rango permitido por semver, y cuándo consideras actualizar a versiones mayores (que pueden incluir breaking changes).
Al terminar, sabrás usar npm outdated, npm update y estrategias para mantener tus proyectos actualizados sin sorpresas.
- Identifica paquetes con nuevas versiones disponibles.
- El comando npm outdated te muestra una tabla con todas las dependencias que tienen versiones más recientes disponibles. La tabla incluye: el paquete, la versión actual, la versión wanted (la más alta dentro del rango permitido por semver) y la latest (la última versión publicada).
- Esta información es crucial para decidir qué actualizar: si 'wanted' y 'latest' son diferentes, significa que actualizar requeriría un cambio de versión mayor (posibles breaking changes).
- Actualiza paquetes sin cambiar major version.
- npm update actualiza paquetes a la versión más reciente dentro del rango permitido por semver en package.json. Si tienes ^4.17.20, actualizará como máximo a 4.x.x (la última minor/patch).
npm outdated: ver qué está desactualizado
Identifica paquetes con nuevas versiones disponibles.
El comando npm outdated te muestra una tabla con todas las dependencias que tienen versiones más recientes disponibles. La tabla incluye: el paquete, la versión actual, la versión wanted (la más alta dentro del rango permitido por semver) y la latest (la última versión publicada).
Esta información es crucial para decidir qué actualizar: si 'wanted' y 'latest' son diferentes, significa que actualizar requeriría un cambio de versión mayor (posibles breaking changes).
npm update: actualizar dentro del rango
Actualiza paquetes sin cambiar major version.
npm update actualiza paquetes a la versión más reciente dentro del rango permitido por semver en package.json. Si tienes ^4.17.20, actualizará como máximo a 4.x.x (la última minor/patch).
Este comando es seguro porque respeta las restricciones de versión que definiste. No te dará una versión que pueda romper tu código.
Actualizar a major versions: con cuidado
Cuándo y cómo actualizar a nuevas major versions.
Actualizar a una major version (como de 4.x a 5.x) puede incluir breaking changes. Antes de hacer esto, verifica el changelog del paquete para ver qué cambió. Muchas librerías tienen guías de migración.
Para actualizar a una major version, suelen publicarse versiones intermedias que ayudan a migrar. No actualices sin leer primero qué cambió.
- Lee el changelog antes de actualizar major
- Busca guías de migración
- Prueba en un entorno de staging primero
- Considera usar herramientas como npm-check-updates
npm-check-updates: herramienta avanzada
Una herramienta más potente que npm outdated.
npm-check-updates (ncu) es una herramienta que va más allá de npm outdated: te muestra todas las actualizaciones disponibles, incluyendo major versions, y te permite actualizar package.json automáticamente.
Es especialmente útil para proyectos que llevan tiempo sin actualizarse y necesitan una revisión completa.
Estrategia de actualización recomendada
Un proceso seguro para mantener proyectos actualizados.
La mejor estrategia es actualizar regularmente (semanal o quincenalmente) en lugar de esperar meses. Así los cambios son pequeños y manejables. Antes de actualizar, corre los tests para verificar que todo funciona.
Usa npm outdated regularmente para estar al día. Considera herramientas automatizadas como Dependabot que crean PRs automáticos cuando hay actualizaciones disponibles.
- Actualiza regularmente (no esperes meses)
- Ejecuta tests antes y después de actualizar
- Revisa changelogs de paquetes importantes
- Considera Dependabot o similar