npm betikleri, bir JavaScript projesinde görevleri otomatikleştirmek için kullanabileceğiniz bir dizi uçbirim komutunu bir araya getirir. Ayrıca, farklı ortamlarda komutları çalıştırmanın tutarlı bir yolunu da sağlarlar.
npm betiklerini bir package.json dosyasında ayarlayabilir, komut satırında çalıştırabilir ve davranışlarını yapılandırmak için çok çeşitli seçenekler kullanabilirsiniz.
package.json Dosyasında npm Komut Dosyalarını Ayarlama
Npm betiklerini genellikle JavaScript projenizin kök dizininde bulunan bir package.json dosyasında tanımlarsınız. Diğer dosyalardan betik çalıştırabileceğiniz için bu bir zorunluluk değildir, ancak package.json, betiklerinize erişmeyi ve bunları yönetmeyi kolaylaştırır.
Devam etmek için geliştirme ortamınızda npm ve Node kurulu olması gerektiğini unutmayın. İşte bazı yararlı makaleler:
- Nasıl Node.js ve npm'yi Windows'a yükleyin.
- Nasıl Node.js ve npm'yi Ubuntu'ya kurun.
package.json'da bir npm komut dosyası ayarlamak için aşağıdaki adımları izleyin:
- Projenizin köküne gidin.
- Terminalde npm init'i çalıştırın. Komut size projeniz hakkında bazı sorular soracaktır. Uygun bir package.json dosyası oluşturmak için bunları yanıtlayın.
npm başlangıç - package.json dosyasında betikler alanını bulun. Burada, bir betiğin adını ve çalıştırması gereken komutu anahtar/değer çiftleri olarak ekleyebilirsiniz. Örneğin, merhaba dünya adlı aşağıdaki komut dosyası çalıştırıldığında terminalde "Merhaba dünya" yazdırır.
{
"Kodlar": {
"Selam Dünya": "Eko \\"Selam Dünya\\""
}
}
JavaScript projeleri için bazı genel betikler şunlardır:
- başlangıç: Bu betik geliştirme sunucusunu başlatır. Örneğin, bir Düğüm projesinde, nodemon kullanarak sunucuyu çalıştırın.
- inşa etmek: Uygulamanız için üretim kodunu oluşturur ve kodu küçültmek ve gruplamak için web paketi gibi bir araç kullanabilir.
- Ölçek: Bu komut dosyası, projenizde tanımlanan testleri çalıştırır. Jest gibi bir test çerçevesi çalıştırabilir.
- tiftik: Bir lint betiği, kodda olası hatalar olup olmadığını kontrol etmek için ESLint gibi bir lintleme aracı çalıştırır.
- kol saati: Bu komut dosyası, kaynak kodunu değişiklikler için izler ve ardından bir komut çalıştırır. Testleri yeniden çalıştırmak veya kod değişikliğinde uygulamayı yeniden oluşturmak için kullanışlıdır.
- dağıtmak: Uygulamayı üretim veya hazırlama gibi belirtilen ortama dağıtan bir komut çalıştırır.
Ön ve Son Komut Dosyaları
npm, ön ve son betikleri destekler. Ön betikler belirli bir betikten önce, post betikler ise daha sonra çalışır. Herhangi bir komut dosyası için ön ve son komut dosyaları oluşturabilirsiniz, yalnızca komut dosyanızın adının önüne "pre" veya "post" ekleyin.
Örneğin, aşağıda sırasıyla test komut dosyasından önce ve sonra çalışacak ön test ve son test komut dosyaları bulunmaktadır.
{
"Kodlar": {
"ön test": "npm tüy bırakma",
"Ölçek": "alay",
"son test": "npm çalıştırma derlemesi"
}
}
package.json'dan npm Komut Dosyalarını Çalıştırma
package.json'a bir npm betiği ekledikten sonra, onu npmrun komutunu kullanarak çalıştırabilirsiniz.
İşte sözdizimi:
npm koşusu
Örneğin, daha önce tanımlanan başlangıç komut dosyasını çalıştırmak için şunu kullanın:
npm çalıştırma başlangıcı
Bir projedeki tüm kullanılabilir betiklerin listesini almak için npmrun komutunu tek başına çalıştırabilirsiniz. İşte bazı örnek çıktılar:
"npm run-script" aracılığıyla [email protected]'da bulunan komut dosyaları:
Selam Dünya
yankı "Merhaba dünya"
Komut dosyasının adını ve çalıştırdığı komutu listeler.
Yerleşik Komut Dosyalarını Çalıştırmak için Kısa Komutları Kullanma
npm, kestirme komutları kullanarak çalıştırabileceğiniz birkaç yerleşik betiği destekler. Örneğin, start adlı bir npm betiğini çalıştırmak için npm run start yerine npm start kullanabilirsiniz.
Bu, tam komutu yazmaktan daha kullanışlı ve hızlıdır. Bunun gibi çalıştırabileceğiniz diğer yerleşik betikler arasında "test", "durdur" ve "yeniden başlat" yer alır.
Birden Fazla npm Komut Dosyası Çalıştırma
Birden çok npm betiğini iki şekilde çalıştırabilirsiniz:
- sırayla
- Paralel
Linux veya başka herhangi bir Unix benzeri sistem kullanıyorsanız, standardı kullanabilirsiniz. aynı anda birden fazla komut çalıştırma yöntemleri.
Birden fazla npm betiğini sırayla çalıştırmak için && kullanın, örneğin:
npm çalıştırma başlangıcı && npm testi
Birden çok npm betiğini paralel olarak çalıştırmak için & kullanın, örneğin:
npm çalıştırma sunucusu ve npm çalıştırma istemcisi
UNIX olmayan ortamlarda, npm-run-all komutunu veya eşzamanlı olarak npm paketini kullanabilirsiniz.
npm-run-all'ı kullanarak:
npm-run-all --paralel sunucu istemcisi
package.json'da eşzamanlı olarak kullanma.
"Kodlar": {
"dev": "aynı anda \\"npm çalıştırma sunucusu\\" \\"npm çalıştırma istemcisi\\"",
}
npm-run-all ve Concurrently paketlerini kullanmadan önce kurmanız gerektiğini unutmayın.
Yaygın Npm Komut Dosyası Hatalarında Sorun Giderme
Aşağıda, npm betiklerini çalıştırırken karşılaşabileceğiniz bazı yaygın hatalar verilmiştir:
- npm hatası! eksik komut dosyası — Bu hata, package.json dosyasında çalıştırmaya çalıştığınız betiği tanımlamadığınızda ortaya çıkar. Betik adını doğru yazdığınızdan ve bunun package.json dosyasının betikler alanında tanımlandığından emin olun.
- İzin reddedildi — Bu hata, bir komut dosyasını çalıştırma izniniz olmadığında ortaya çıkar, bu nedenle doğru izinlere sahip olduğunuzdan emin olun.
- Eksik bağımlılıklar — Komut dosyası kurulu olmayan bir paket kullandığında bu hata oluşur. gibi bir araç kullanın depcheck package.json'da eksik olan bağımlılıkları kontrol etmek için npm kurulumunu kullanarak bunları kurun.
- Bilinmeyen komut — Bu hata genellikle yerleşik bir npm komutu olarak özel bir komut dosyası çalıştırdığınızda ortaya çıkar. kullandığınızdan emin olun npm koşusu veya npm run-script özel komut dosyalarını çalıştırırken.
npm Komut Dosyalarında Ortam Değişkenlerini Kullanma
Ortam Değişkenleri bilgileri kodlamadan aktarmanıza izin verir. Ortam değişkenlerini bir npm betiğinde kullanmak için, ortamlar arası npm paketi. Bu araç, herhangi bir ortamda bir çevresel değişken belirlemenize yardımcı olur.
Dev bağımlılığı olarak kurmak için terminalde bu komutu çalıştırarak başlayın:
npm kaydettim -D çapraz ortam
Ardından, betiğinizde şu şekilde kullanın:
{
"Kodlar": {
"inşa etmek": "cross-env NODE_ENV=üretim web paketi"
}
}
Burada çapraz ortam, NODE_ENV değişkenini "üretim" olarak ayarlar.
Komut Satırı Argümanlarını Komut Dosyalarına Aktarma
Komut satırı argümanlarını, komut dosyası adından sonra iki çizgi "--" kullanarak bir npm komut dosyasına iletebilirsiniz. Örneğin, aşağıdaki komut test betiğini watch argümanıyla çalıştırır:
npm çalıştırma testi -- --izle
Bunun gibi bir npm betiğine bir komut satırı argümanı da gönderebilirsiniz:
npm portumu çalıştır --PORT=3000
Ardından komut dosyasında aşağıdaki gibi erişin.
"Kodlar": {
"benim bağlantı noktam": "Eko \\"Bağlantı noktası: $npm_config_PORT\\""
}
Bir Windows sisteminde şunu kullanın:
"Kodlar": {
"benim bağlantı noktam": "Eko \\"Bağlantı noktası: %npm_config_PORT%\\""
}
Komut dosyasını çalıştırdığınızda "Port: 3000" yazmalıdır.
Neden npm Komut Dosyalarını Kullanmalı?
package.json'a komut dosyaları ekleyebilir, bunları komut satırında çalıştırabilir, ön ve son kancaları kullanabilir ve bunlara satır bağımsız değişkenlerini ve ortam değişkenlerini iletebilirsiniz.
npm betikleri, JavaScript projelerinde görevleri otomatikleştirmenin güçlü bir yoludur. Birden çok görevi çalıştırmanız için size tutarlı komutlar sağlayarak iş akışınızı geliştirebilir ve size zaman kazandırabilirler.
