¿Qué son los npm scripts y los hooks del ciclo de vida?

Question

Accepted Answer

Los **npm scripts** son comandos definidos en el campo `scripts` de `package.json` que ejecutas con `npm run `. Estandarizan las tareas del proyecto (start, build, test, lint) para que todo el equipo y CI usen los mismos comandos. Los **hooks del ciclo de vida** son scripts especiales que npm ejecuta automáticamente en ciertos puntos. ## Definir y ejecutar scripts ```json { "scripts": { "start": "node server.js", "dev": "nodemon server.js", "build": "tsc && vite build", "test": "vitest", "lint": "eslint src", "format": "prettier --write ." } } ``` ```bash npm run dev # cualquier script npm start # `start` y `test` tienen atajos (sin necesidad de "run") npm test ``` Los scripts pueden encadenar comandos con `&&` (se ejecutan secuencialmente, se detienen ante una falla) y tienen acceso a los binarios instalados localmente (en `node_modules/.bin`) sin una ruta — de modo que `"test": "vitest"` funciona aunque vitest no sea global. ## Hooks pre y post (automáticos) ```json { "scripts": { "prebuild": "rimraf dist", // se ejecuta AUTOMÁTICAMENTE antes de "build" "build": "tsc", "postbuild": "echo done" // se ejecuta AUTOMÁTICAMENTE después de "build" } } ``` npm ejecuta automáticamente `pre` antes y `post` después de cualquier script ``. Así, `npm run build` ejecuta `prebuild` → `build` → `postbuild` en orden — útil para pasos de preparación/limpieza. ## Hooks integrados del ciclo de vida ```json { "scripts": { "postinstall": "node setup.js", // se ejecuta después de que `npm install` termina "prepare": "husky install" // se ejecuta después de la instalación (comúnmente configura los git hooks) } } ``` Hooks como `postinstall` y `prepare` se ejecutan en momentos definidos del ciclo de vida de la instalación — a menudo usados para configurar git hooks (husky) o compilar dependencias nativas. (Ten cuidado: los scripts `postinstall` en las dependencias también son una consideración de seguridad de la cadena de suministro.) ## Pasar argumentos y variables de entorno ```bash npm run test -- --watch # pasa argumentos al script después de -- NODE_ENV=production npm start # establece una variable de entorno para la ejecución ``` ## Por qué npm scripts en lugar de un Makefile/herramientas globales ```text ✓ Autodocumentado — `package.json` muestra todas las tareas disponibles ✓ Más o menos multiplataforma, sin necesidad de instalaciones globales (usa node_modules/.bin local) ✓ Estándar en todo el ecosistema JS — todo desarrollador conoce `npm run` ``` ## Por qué es importante Los npm scripts son el ejecutor de tareas estándar para los proyectos de Node/JS — centralizan y documentan cómo iniciar, compilar, probar y hacer lint de la app, asegurando que todos (y CI) ejecuten comandos idénticos. Entender la composición de scripts, los hooks automáticos `pre`/`post` (para preparación/limpieza) y los hooks del ciclo de vida como `postinstall`/`prepare` te permite automatizar los flujos de trabajo del proyecto de forma limpia. Son el pegamento de las herramientas del proyecto y aparecen en esencialmente todos los repositorios de Node.