Gli npm scripts sono comandi definiti nel campo scripts di package.json che esegui con npm run <name>. Standardizzano i compiti del progetto (start, build, test, lint) in modo che l'intero team e la CI usino gli stessi comandi. Lifecycle hooks sono script speciali che npm esegue automaticamente in determinati punti.
{
"scripts": {
"start": "node server.js",
"dev": "nodemon server.js",
"build": "tsc && vite build",
"test": "vitest",
"lint": "eslint src",
"format": "prettier --write ."
}
}
npm run dev # any script
npm start # `start` and `test` have shortcuts (no "run" needed)
npm test
Gli script possono concatenare comandi con && (eseguiti sequenzialmente, interrompi in caso di errore) e hanno accesso ai binari installati localmente (in node_modules/.bin) senza percorso — quindi "test": "vitest" funziona anche se vitest non è globale.
{
"scripts": {
"prebuild": "rimraf dist", // runs AUTOMATICALLY before "build"
"build": "tsc",
"postbuild": "echo done" // runs AUTOMATICALLY after "build"
}
}
npm esegue automaticamente pre<name> prima e post<name> dopo qualsiasi script <name>. Quindi npm run build esegue prebuild → build → postbuild in ordine — utile per step di configurazione/pulizia.
{
"scripts": {
"postinstall": "node setup.js", // runs after `npm install` completes
"prepare": "husky install" // runs after install (commonly sets up git hooks)
}
}
Hooks come postinstall e prepare vengono eseguiti in punti definiti del ciclo di vita dell'installazione — spesso usati per configurare git hooks (husky) o compilare dipendenze native. (Attenzione: gli script postinstall nelle dipendenze sono anche una considerazione di sicurezza della catena di approvvigionamento.)
npm run test -- --watch # pass args to the script after --
NODE_ENV=production npm start # set an env var for the run
✓ Self-documenting — `package.json` shows all available tasks
✓ Cross-platform-ish, no global installs needed (uses local node_modules/.bin)
✓ Standard across the JS ecosystem — every dev knows `npm run`
npm scripts sono il task runner standard per i progetti Node/JS — centralizzano e documentano come avviare, costruire, testare e eseguire il linting dell'app, assicurando che tutti (e la CI) eseguano comandi identici.
Comprendere la composizione degli script, gli hook pre/post automatici (per step di configurazione/pulizia) e i lifecycle hooks come postinstall/prepare ti consente di automatizzare in modo pulito i flussi di lavoro del progetto.
Sono la base dei tooling del progetto e appaiono in praticamente ogni repository Node.