Kas yra npm skriptai ir gyvenimo ciklo kabliai?

Question

Accepted Answer

**npm skriptai** yra komandos, apibrėžtos `package.json` failo `scripts` lauke, kurias galite paleisti naudodami `npm run `. Jie standartizuoja projekto užduotis (start, build, test, lint), kad visa komanda ir CI naudotų tas pačias komandas. **Gyvenimo ciklo kabliai** yra specialūs skriptai, kuriuos npm automatiškai paleidžia tam tikrais momentais. ## Skriptų apibrėžimas ir paleidimas ```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 ``` Skriptai gali susieti komandas su `&&` (paleisti nuosekliai, sustoti jei nepavyko) ir turi prieigą prie lokaliai įdiegtų binarinių failų (`node_modules/.bin`) be kelio — todėl `"test": "vitest"` veikia net jei vitest nėra globaliai įdiegtas. ## Pre ir post kabliai (automatiniai) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm automatiškai paleidžia `pre` prieš ir `post` po bet kurio skripto ``. Taigi `npm run build` paleidžia `prebuild` → `build` → `postbuild` iš eilės — naudinga nustatymo/valymo žingsniams. ## Įmontuoti gyvenimo ciklo kabliai ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Kabliai, tokie kaip `postinstall` ir `prepare`, paleidžiami nustatytuose diegimo gyvenimo ciklo momentuose — dažnai naudojami git kablių (husky) nustatymui arba native priklausomybių kompiliavimui. (Būk atsargus: `postinstall` skriptai priklausomybėse yra ir tiekimo grandinės saugumo problema.) ## Argumentų ir aplinkos kintamųjų persiuntimas ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Kodėl npm skriptai geriau nei Makefile/globalūs įrankiai ```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` ``` ## Kodėl tai svarbu npm skriptai yra standartinis užduočių vykdytojas Node/JS projektams — jie centralizuoja ir dokumentuoja, kaip paleisti, sustatyti, testuoti ir lint programą, užtikrindami, kad visi (ir CI) paleidžia identiškas komandas. Supratvus skriptų sudėtį, automatinius `pre`/`post` kabliais (nustatymo/valymo etapams) ir gyvenimo ciklo kabliais, tokiais kaip `postinstall`/`prepare`, galite švariai automatizuoti projekto darbo srautus. Jie yra projekto įrankių klijai ir pasirodo beveik kiekviename Node saugyklose.