Ce sunt npm scripts și lifecycle hooks?

Question

Accepted Answer

**npm scripts** sunt comenzi definite în câmpul `scripts` din `package.json` pe care le rulezi cu `npm run `. Ele standardizează sarcinile proiectului (start, build, test, lint) pentru ca întreaga echipă și CI să utilizeze aceleași comenzi. **Lifecycle hooks** sunt scripturi speciale pe care npm le execută automat la anumite momente. ## Definirea și rularea scripturilor ```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 ``` Scripturile pot înlănțui comenzi cu `&&` (rulare secvențială, oprire la eșec) și au acces la binare instalate local (în `node_modules/.bin`) fără cale — deci `"test": "vitest"` funcționează chiar dacă vitest nu este instalat global. ## Pre și post hooks (automate) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm rulează automat `pre` înainte și `post` după orice script ``. Deci `npm run build` execută `prebuild` → `build` → `postbuild` în ordine — util pentru pași de configurare/curățare. ## Lifecycle hooks încorporate ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Hookuri precum `postinstall` și `prepare` se rulează la momente definite din ciclul de instalare — adesea utilizate pentru a configura git hooks (husky) sau a compila dependențe native. (Fiți atenți: scripturile `postinstall` din dependențe sunt, de asemenea, o considerație de securitate în lanțul de aprovizionare.) ## Trecerea argumentelor și variabilelor de mediu ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## De ce npm scripts în loc de Makefile/instrumente globale ```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` ``` ## De ce este important npm scripts sunt task runner-ul standard pentru proiecte Node/JS — ele centralizează și documentează cum să porniți, construiți, testați și verificați aplicația, asigurând că toată lumea (și CI) execută comenzi identice. Înțelegerea compoziției scripturilor, a hookurilor automate `pre`/`post` (pentru configurare/curățare) și a lifecycle hooks-urilor precum `postinstall`/`prepare` vă permite să automatizați curele de lucru ale proiectului în mod curat. Sunt lipiciul instrumentelor proiectului și apar în esență în fiecare depozitar Node.