Çfarë janë skriptat npm dhe lifecycle hooks?

Question

Accepted Answer

**skriptat npm** janë komandat e përcaktuara në fushën `scripts` të `package.json` që ekzekutoni me `npm run `. Ato standardizojnë detyrat e projektit (start, build, test, lint) në mënyrë që i gjithë ekipi dhe CI të përdorin të njëjtat komanda. **Lifecycle hooks** janë skripte të veçanta që npm ekzekuton automatikisht në pika të caktuara. ## Përcaktimi dhe ekzekutimi i skriptave ```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 ``` Skriptat mund të zinxhirojnë komandat me `&&` (ekzekutohen në mënyrë sekuenciale, ndalen në gabim) dhe kanë qasje në binare të instaluara lokalisht (në `node_modules/.bin`) pa rrugë — prandaj `"test": "vitest"` funksionon edhe pse vitest nuk është global. ## Pre dhe post hooks (automatik) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm ekzekuton automatikisht `pre` përpara dhe `post` pas çdo skripty ``. Pra `npm run build` ekzekuton `prebuild` → `build` → `postbuild` në rend — i dobishëm për hapat e konfigurimit/pastrimit. ## Lifecycle hooks të integruar ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Hooks si `postinstall` dhe `prepare` ekzekutohen në momente të përcaktuara të lifecycle-it të instalimit — shpesh përdoren për të konfiguruar git hooks (husky) ose për të përpiluar varësi native. (Kini kujdes: skriptat `postinstall` në varësi janë gjithashtu një konsideratë e sigurisë të zinxhirit të furnizimit.) ## Kalimi i argumenteve dhe variablave të mjedisit ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Pse skriptat npm në vend të Makefile/mjeteve 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` ``` ## Pse është i rëndësishëm Skriptat npm janë task runner-i standard për projektet Node/JS — ato centralizojnë dhe dokumentojnë se si të niseni, ndërtoni, testoni dhe lintoni aplikacionin, duke siguruar që të gjithë (dhe CI) ekzekutojnë komandat identike. Komprehensioni i përbërjes së skriptave, automatic `pre`/`post` hooks (për setup/pastrimin), dhe lifecycle hooks si `postinstall`/`prepare` ju lejon të automatizoni workflow-et e projektit në mënyrë të pastër. Ato janë ngjitësi i mjeteve të projektit dhe shfaqen në fakt në çdo repozitor Node.