Node.js y npm: scripts y dependencias de un proyecto

Navegador y Node.js no son el mismo entorno

Ambos ejecutan JavaScript, pero las APIs disponibles difieren. El DOM y document pertenecen al entorno del navegador; Node.js proporciona APIs para tareas como trabajar con archivos. Un ejemplo que modifica document no funcionará directamente como un script de Node.js sin un entorno DOM adicional.

package.json y scripts

package.json describe el paquete y su configuración. En scripts puedes asignar nombres a comandos. En una carpeta de práctica, crea este archivo y un archivo saludo.js con console.log("Hola"). npm run saludo ejecutará el comando definido.

{
  "name": "biblioteca-ejemplo",
  "private": true,
  "scripts": {
    "saludo": "node saludo.js"
  }
}

Dependencias de ejecución y desarrollo

dependencies declara paquetes necesarios para usar el proyecto según su distribución. devDependencies suele agrupar herramientas de desarrollo, como pruebas o compilación. En una aplicación que se compila antes de desplegar, esas herramientas pueden ser necesarias durante la construcción aunque no se usen al ejecutar el resultado.

install, lockfile y ci

npm install instala dependencias y puede actualizar package-lock.json, que registra el árbol resuelto. npm ci necesita un lockfile existente, falla si no coincide con package.json y elimina node_modules antes de instalar. Es apropiado para una instalación reproducible desde esos archivos; no sirve para añadir un paquete individual.

node --version
npm --version
npm run saludo
# En un proyecto con package-lock.json compatible:
npm ci

Antes de ejecutar un proyecto ajeno

Lee sus scripts y requisitos de Node.js. Instalar paquetes o ejecutar scripts puede ejecutar código, por lo que conviene usar dependencias de procedencia conocida. Conserva el lockfile del proyecto y evita cambiar de gestor de paquetes sin revisar cómo se instala en el equipo y en integración continua.

Práctica

1. Ejecuta saludo y confirma que imprime Hola.
2. Cambia el nombre del archivo sin cambiar el script y observa el error de ruta.
3. Corrige el script y vuelve a ejecutarlo; comprueba que la solución corresponde al error observado.