ما هي npm scripts و lifecycle hooks؟

Question

Accepted Answer

**npm scripts** هي أوامر معرّفة في حقل `scripts` في `package.json` التي تشغلها باستخدام `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` قبل و `post` بعد أي script ``. لذا `npm run build` يشغل `prebuild` → `build` → `postbuild` بالترتيب — مفيد لخطوات الإعداد والتنظيف. ## 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` في لحظات محددة من دورة التثبيت — غالباً ما تُستخدم لإعداد git hooks (husky) أو ترجمة الاعتماديات الأصلية. (كن حذراً: `postinstall` scripts في الاعتماديات هي أيضاً اعتبار أمان سلسلة التوريد.) ## تمرير الحجج ومتغيرات البيئة ```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/أدوات عامة ```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 — تقوم بتجميع وتوثيق كيفية بدء واختبار وبناء ولصحة التطبيق، مما يضمن أن الجميع (و CI) يشغلون أوامر متطابقة. فهم تكوين script، و auto `pre`/`post` hooks (للإعداد/التنظيف)، و lifecycle hooks مثل `postinstall`/`prepare` يتيح لك أتمتة سير عمل المشروع بنظافة. هي الغراء الذي يربط أدوات المشروع ويظهر في جميع مستودعات Node بشكل أساسي.