Que sont les scripts npm et les lifecycle hooks ?

Question

Accepted Answer

**Les scripts npm** sont des commandes définies dans le champ `scripts` de `package.json` que vous exécutez avec `npm run `. Ils standardisent les tâches du projet (start, build, test, lint) afin que toute l'équipe et le CI utilisent les mêmes commandes. **Les lifecycle hooks** sont des scripts spéciaux que npm exécute automatiquement à certains moments. ## Définition et exécution des 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 # any script npm start # `start` and `test` have shortcuts (no "run" needed) npm test ``` Les scripts peuvent enchaîner des commandes avec `&&` (exécution séquentielle, arrêt en cas d'échec) et ont accès aux binaires installés localement (dans `node_modules/.bin`) sans chemin — donc `"test": "vitest"` fonctionne même si vitest n'est pas global. ## Pre et post hooks (automatique) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm exécute automatiquement `pre` avant et `post` après n'importe quel script ``. Donc `npm run build` exécute `prebuild` → `build` → `postbuild` dans l'ordre — utile pour les étapes de configuration/nettoyage. ## Lifecycle hooks intégrés ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Les hooks comme `postinstall` et `prepare` s'exécutent à des moments définis du cycle de vie de l'installation — souvent utilisés pour configurer les git hooks (husky) ou compiler les dépendances natives. (Attention : les scripts `postinstall` dans les dépendances sont également une préoccupation de sécurité de la chaîne d'approvisionnement.) ## Passage des arguments et des variables d'environnement ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Pourquoi les scripts npm plutôt qu'un Makefile/des outils globaux ```text ✓ 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` ``` ## Pourquoi c'est important Les scripts npm sont le task runner standard pour les projets Node/JS — ils centralisent et documentent comment démarrer, construire, tester et linter l'application, ce qui garantit que tout le monde (et le CI) exécute les mêmes commandes. Comprendre la composition des scripts, les hooks `pre`/`post` automatiques (pour la configuration/nettoyage) et les lifecycle hooks comme `postinstall`/`prepare` vous permet d'automatiser proprement les flux de travail du projet. Ils sont l'adhésif des outils du projet et apparaissent dans pratiquement tous les dépôts Node.