npm scripts, package.json dosyasının scripts alanında tanımlanan ve npm run <name> ile çalıştırılan komutlardır. Proje görevlerini (start, build, test, lint) standardize ederek tüm takım ve CI'nin aynı komutları kullanmasını sağlarlar. Lifecycle hooks, npm'nin belirli noktalarda otomatik olarak çalıştırdığı özel scriptlerdir.
{
"scripts": {
"start": "node server.js",
"dev": "nodemon server.js",
"build": "tsc && vite build",
"test": "vitest",
"lint": "eslint src",
"format": "prettier --write ."
}
}
npm run dev # any script
npm start # `start` and `test` have shortcuts (no "run" needed)
npm test
Script'ler komutları && ile zincirleyebilir (sırasıyla çalıştır, hata durumunda dur) ve yerel olarak yüklenmiş ikili dosyalara (in node_modules/.bin) yol olmadan erişebilirler — bu nedenle vitest global olmasa bile "test": "vitest" çalışır.
{
"scripts": {
"prebuild": "rimraf dist", // runs AUTOMATICALLY before "build"
"build": "tsc",
"postbuild": "echo done" // runs AUTOMATICALLY after "build"
}
}
npm otomatik olarak herhangi bir script <name> öncesinde pre<name> ve sonrasında post<name> çalıştırır. Böylece npm run build, prebuild → build → postbuild sırasında çalışır — kurulum/temizlik adımları için kullanışlıdır.
{
"scripts": {
"postinstall": "node setup.js", // runs after `npm install` completes
"prepare": "husky install" // runs after install (commonly sets up git hooks)
}
}
postinstall ve prepare gibi hook'lar install lifecycle'ın tanımlanmış noktalarında çalışır — genellikle git hook'larını (husky) ayarlamak veya yerel bağımlılıkları derlemek için kullanılır. (Dikkat: bağımlılıklardaki postinstall script'leri aynı zamanda supply-chain güvenliği açısından da bir husustur.)
npm run test -- --watch # pass args to the script after --
NODE_ENV=production npm start # set an env var for the run
✓ 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, Node/JS projeleri için standart task runner'dır — uygulamayı başlatmanın, derlemenin, test etmenin ve linting yapmanın nasıl olduğunu merkezi hale getirir ve belgeler, herkesin (ve CI'nin) aynı komutları çalıştırmasını sağlar.
Script bileşimi, otomatik pre/post hook'larını (kurulum/temizlik için) ve postinstall/prepare gibi lifecycle hook'larını anlamak proje iş akışlarını temiz bir şekilde otomatikleştirmenizi sağlar.
Bunlar proje araç yönetiminin "tutkalı"dır ve esasen her Node repository'de görülür.