Что такое npm скрипты и lifecycle hooks?

Question

Accepted Answer

**npm скрипты** — это команды, определённые в поле `scripts` файла `package.json`, которые выполняются через `npm run `. Они стандартизируют задачи проекта (start, build, test, lint), чтобы вся команда и CI использовали одни и те же команды. **Lifecycle hooks** — это специальные скрипты, которые npm запускает автоматически в определённые моменты. ## Определение и запуск скриптов ```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 ``` Скрипты могут объединять команды с помощью `&&` (выполнять последовательно, останавливаться при ошибке) и имеют доступ к локально установленным бинарникам (в `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` перед и `post` после любого скрипта ``. Так `npm run build` выполняет `prebuild` → `build` → `postbuild` по порядку — удобно для этапов инициализации и очистки. ## Встроенные 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`, запускаются в определённые моменты жизненного цикла установки — часто используются для настройки git hooks (husky) или компиляции нативных зависимостей. (Будьте внимательны: `postinstall` скрипты в зависимостях — это также вопрос безопасности цепочки поставок.) ## Передача аргументов и переменных окружения ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Почему npm скрипты вместо Makefile/глобальных инструментов ```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 скрипты — это стандартный task runner для Node/JS проектов — они централизируют и документируют, как запустить, собрать, протестировать и проверить приложение, гарантируя, что все (и CI) выполняют одинаковые команды. Понимание композиции скриптов, автоматических `pre`/`post` hooks (для инициализации/очистки) и lifecycle hooks, таких как `postinstall`/`prepare`, позволяет вам автоматизировать рабочие процессы проекта чистым образом. Они — «клей» инструментов проекта и появляются практически в каждом репозитории Node.