Mit jelent az npm scripts és a lifecycle hooks?

Question

Accepted Answer

Az **npm scripts** parancsok, amelyeket a `package.json` `scripts` mezőjében határoznak meg, és a `npm run ` segítségével futtatnak. A projekt feladatait (start, build, test, lint) szabványosítják, hogy az egész csapat és a CI ugyanazokat a parancsokat használja. A **lifecycle hooks** olyan speciális szkriptek, amelyeket az npm automatikusan bizonyos pontokon futtat. ## Szkriptek definiálása és futtatása ```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 ``` A szkriptek parancsokat láncolhatnak `&&` segítségével (szekvenciális futtatás, leállás hibánál), és hozzáférést biztosítanak a helyileg telepített binárisokhoz (a `node_modules/.bin` mappában) útvonal nélkül — így a `"test": "vitest"` működik, még akkor is, ha a vitest nem globális. ## Pre és post hooks (automatikus) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` Az npm automatikusan futtatja a `pre` előtte és a `post` után bármely `` szkripthez. Tehát az `npm run build` futtatja a `prebuild` → `build` → `postbuild` sorrendben — hasznos a beállítás/tisztítás lépésekhez. ## Beépített lifecycle hooks ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` A `postinstall` és `prepare` hookokat a telepítési életciklus meghatározott pontjaiban futtatják — gyakran git hooks (husky) beállítására vagy natív függőségek fordítására használják. (Vigyázat: a `postinstall` szkriptek a függőségekben szintén ellátási lánc biztonsági megfontolások.) ## Argumentumok és env var átadása ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Miért npm scripts a Makefile/globális eszközök helyett ```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` ``` ## Miért fontos Az npm scripts a Node/JS projektek szabványos feladat futtatói — központosítják és dokumentálják az alkalmazás indítását, felépítését, tesztelését és linting-jét, biztosítva, hogy mindenki (és a CI) azonos parancsokat futtat. A szkript-összeállítás, az automatikus `pre`/`post` hook (beállítás/tisztítás lépésekhez) és az `postinstall`/`prepare` által meghatározott lifecycle hookokat megértve tisztán automatizálhatja a projekt munkafolyamatait. Ezek a projekteszközöz ragasztói, és szinte minden Node adattárban megjelennek.