რა არის npm scripts და lifecycle hooks?

Question

Accepted Answer

**npm scripts** არის ბრძანებები, რომლებიც განსაზღვრულია `package.json`-ის `scripts` ველში და ეშვებათ `npm run ` ბრძანებით. ისინი სტანდარტიზებენ პროექტის ამოცანებს (start, build, test, lint) ისე, რომ მთელი გუნდი და CI იყენებს ერთსა და იმავე ბრძანებებს. **Lifecycle hooks** არის სპეციალური scripts, რომელსაც npm ავტომატურად იშვებს გარკვეულ მომენტში. ## 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 ``` Scripts-ი შეიძლება დააკავშირო ბრძანებები `&&` ოპერატორით (თანმიმდევრობით გაშვება, შეწყვეტა უშეცდომოდ) და აქვს წვდომა ლოკალურად დაყენებულ ბინარებზე (`node_modules/.bin` საქაღალდეში) გზის მითითების გარეშე — ამიტომ `"test": "vitest"` მუშაობს მაშინაც კი, როდესაც vitest გლობალურად დაყენებული არ არის. ## Pre და post hooks (ავტომატური) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm ავტომატურად იშვებს `pre` script-ს და `post` script-ს ნებისმიერი `` script-ის შემდეგ. ამიტომ `npm run build` იშვებს `prebuild` → `build` → `postbuild` თანმიმდევრობით — სასარგებლო setup/cleanup ნაბიჯებისთვის. ## Built-in lifecycle hooks ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Hooks-ი, როგორიცაა `postinstall` და `prepare`, ეშვება install lifecycle-ის განსაზღვრულ მომენტში — ხშირად გამოიყენება git hooks-ის (husky) დაყენებისთვის ან native dependency-ების კომპილირებისთვის. (ფრთხილი იყავი: `postinstall` scripts dependency-ებში ასევე არის supply-chain უსაფრთხოების გათვალისწინება.) ## არგუმენტების და env vars-ის გადაცემა ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## რატომ npm scripts Makefile/global tools-ის ნაცვლად ```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` ``` ## რატომ არის ეს მნიშვნელოვანი npm scripts არის სტანდარტული task runner Node/JS პროექტებისთვის — ეს ცენტრალიზებს და დოკუმენტირებს თუ როგორ დაიწყოთ, აღმოაჩინოთ, ტესტი და lint გააკეთოთ აპ, რათა ყველა (და CI) იდენტური ბრძანებებს გაშვებს. script-ის კომპოზიციის, ავტომატური `pre`/`post` hooks-ის (setup/cleanup-ისთვის) და lifecycle hooks-ის, როგორიცაა `postinstall`/`prepare`-ის გაგება საშუალებას გაძლევთ პროექტის სამუშაო ნაბიჯებს ავტომატიზაციას გაუკეთოთ დახელმძღვანებით. ისინი პროექტის tooling-ის წებო და ჩნდებიან აქეთ-იქით ყველა Node რეპოზიტორიაში.