Mitä ovat npm-skriptit ja lifecycle hooks?

Question

Accepted Answer

**npm-skriptit** ovat `package.json`-tiedoston `scripts`-kentässä määriteltyjä komentoja, joita ajotat komennolla `npm run `. Ne standardoivat projektitehtävät (start, build, test, lint) siten, että koko tiimi ja CI käyttävät samoja komentoja. **Lifecycle hooks** ovat erityisiä skriptejä, jotka npm ajaa automaattisesti tietyissä vaiheissa. ## Skriptien määrittäminen ja ajaminen ```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 ``` Skriptit voivat ketjuttaa komentoja `&&`-operaattorin avulla (suorita peräkkäin, pysäytä virheessä) ja niillä on pääsy paikallisesti asennettuihin binaareihin (`node_modules/.bin`-kansiossa) ilman polkua — joten `"test": "vitest"` toimii vaikka vitest ei olisi globaalisti asennettu. ## Pre ja post hooks (automaattinen) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm ajaa automaattisesti `pre`-skriptiä ennen ja `post`-skriptiä jälkeen mistä tahansa skriptista ``. Joten `npm run build` ajaa `prebuild` → `build` → `postbuild` järjestyksessä — kätevä asetuksien ja siivouksen vaiheille. ## Sisäänrakennetut lifecycle hooks ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Hookit kuten `postinstall` ja `prepare` ajetaan asennuksen elinkaaren määritellyissä vaiheissa — usein käytetään git hookkien (husky) asettamiseen tai natiivikirjastojen kääntämiseen. (Ole varovainen: `postinstall`-skriptit riippuvuuksissa ovat myös toimitusketjun turvallisuushuomio.) ## Argumenttien ja env-muuttujien välittäminen ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Miksi npm-skriptit Makefilen/globaalien työkalujen sijaan ```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` ``` ## Miksi se on tärkeää npm-skriptit ovat Node/JS-projektien vakio task runner — ne keskittävät ja dokumentoivat kuinka sovellusta käynnistetään, rakennetaan, testataan ja lintaa, varmistaen että kaikki (ja CI) ajavat identtisiä komentoja. Skriptien yhdistelmisen ymmärtäminen, automaattisten `pre`/`post` hookkien (asetus/siivous) ja elinkaari-hookkien kuten `postinstall`/`prepare` avulla voit automatisoida projektin työnkulut siististi. Ne ovat projektityökalujen liima ja esiintyvät käytännössä jokaisessa Node-tietovarastossa.