Node.js projenize paketleri ekleme

  • 11 dakika

Node.js, dosya yönetimi ve HTTP işleme gibi görevler için yerleşik paketler içerir. Ancak NPM kayıt defterinde sunulan çok çeşitli üçüncü taraf paketleri de vardır.

Npm paketi ne zaman ve nasıl seçilir?

Tailwind Traders'da yeni bir geliştirici olarak bir projeye işlevsellik eklemeniz gerekir. Kodu kendiniz yazabilirsiniz, ancak mevcut bir paketi kullanmaya karar verirsiniz. Bu geliştirme kararı yaygın bir senaryodur.

Mevcut bir paketi ne zaman kullanmalısınız? Dikkate alınması gereken bazı faktörler şunlardır:

  • Kalite: Güvenlik gibi görevler için, iyi oluşturulmuş paketlerin kullanılması en iyi yöntemleri izlemenizi ve uç servis taleplerini işlemenizi sağlar.
  • Verimlilik: Kendi kodunuzu yazmak zaman alır. Mevcut paketlerin kullanılması size önemli ölçüde çaba kazandırabilir.
  • Bakım: Kitaplıklar güncelleştirmelere ve hata düzeltmelerine ihtiyaç duyar. Bunu açık kaynak bir ekibin halletmesine izin vermek genellikle daha verimli olur.

Geliştiriciler aşağıdakiler gibi çeşitli kaynaklardan paketler bulabilir ve indirebilir:

  • Kayıt defterleri: Kayıt defterleri, npm kayıt defteri gibi paket koleksiyonlarıdır. Ayrıca kendi kayıt defterinizi de barındırabilirsiniz.
  • Depolar: Paketleri doğrudan bir GitHub URL'sinden yükleyebilirsiniz.
  • Dosyalar: Paketler yerel bir klasörden veya sıkıştırılmış dosyadan yüklenebilir; kendi paketlerinizi test etmede kullanışlıdır.
  • Dizinler: Doğrudan bir dizinden de yükleyebilirsiniz.

Bir paketi seçtikten sonra aşağıdaki faktörleri dikkate almak için paketin bağımlılıklarını denetleyin:

  • Boyut: Daha fazla bağımlılık, daha büyük bir ayak izi anlamına gelir. Bant genişliği veya donanım sınırlamalarınız varsa ayak izi boyutu önemlidir. Unutmayın, bir paketin yüklenmesi bağımlılıklarını da yükler. Bu, büyük bir node_modules klasörüne neden olabilir.
  • Popülerlik: Bir paketin popülerliği, kalitesini gösterebilir.
  • Lisanslama: Yazılımınızı satmayı planlıyorsanız, tüm bağımlılık paketi lisanslarının yeniden kullanıma ve yeniden satışa izin verin.
  • Etkin bakım: Kullanım dışı bırakılan veya nadiren güncelleştirilen bağımlılıklardan kaçının.

Paket hakkında daha fazla bilgi edinmek için NPM'de paket sayfasını ve GitHub depolarını ziyaret edin. npm komutunu da kullanabilirsiniz: npm view <package name>.

Paketi yükleme

Paket yüklemek için Node.js ile yüklenen npm CLI'yi kullanın. Terminaldeki komutuyla npm install Node.js projenize bir paket ekleyebilirsiniz.

npm install <name of package>

Komutu çalıştırdığınızda install , komut satırı aracı genel kayıt defterine bağlanır, kodu getirir ve projenizin kökündeki bir node_modules klasöre yerleştirir.

Yükleme komutu için bazı yaygın anahtarlar şunlardır:

  • Yalnızca geliştirme paketleri için kullanın --save-dev. Bu anahtar özelliğine devDependencies package.jsonkaydedilir. Bu bağımlılıklar genellikle biçim, lint, derleme, dönüştürme ve test araçlarıdır.
  • Yalnızca üretim paketleri için kullanın --production. Bu anahtar yalnızca geliştirme paketlerini dışlar.
  • Genel olarak kullanılabilen araçlar için kullanın -g. Komut satırı araçları genellikle projelere içeri aktarmak yerine genel olarak yüklenir. Genel bağımlılıklar proejct düzeyinde değil sistem genelindeki node_modulesbir dizine yüklenir. Ancak genel paketler sisteminizi karmaşık hale gelebilir. npx komutu, paketleri geçici olarak yükleyerek bu sorunu çözer. Bir paketi getirmek, çalıştırmak ve ardından kaldırmak için kullanın npx <name> .

Yüklemeden sonra proje dizininiz aşağıdaki örneğe benzer:

package.json
node_modules/
  <name of dependency>/
    <files included in the dependency>
src
  index.js

npm CLI komutları

npm komut satırı aracının paketleri yükleme, paket yazma ve Node.js projelerini başlatma gibi görevlerde size yardımcı olacak birkaç komutu vardır.

NPM komutları kategorilere ayrılır:

  • Bağımlılıkları yönetme: Paketleri yükleme, güncelleştirme ve kaldırma komutları.
  • Betikleri çalıştırma: Test etme ve kod oluşturma gibi geliştirme akışlarını yönetmeye yönelik komutlar.
  • Ortamı yapılandırma: Yükleme yollarını ve paket kaynaklarını ayarlama komutları.
  • Paketleri yazma ve yayımlama: Paketleri oluşturma ve yayımlama komutları.

Tüm komutların ayrıntılı bir listesini istiyorsanız terminale aşağıdaki komutu girin:

npm --help

Yüklemeyi doğrulama

Klasörünüzde package.json neler olduğunu görmek için kullanın npm list. komutu npm list , yüklenen dizindeki node_modules tüm paketleri listeler. Yüklenen her paket kendi bağımlılıklarının tümünü yükledi.

Komutu uzun list bir listeye neden olabileceğinden, anlaşılması zor olduğundan, liste komutuyla paketleri farklı derinliklerde listeleyebilirsiniz. Komut, 0 derinliğinde package.json dosyanızın dependencies bölümünde yer alan içeriğin aynısını listeler.

npm list --depth=<depth>

Jest paketini yüklediyseniz, npm list --depth=0 şu çıkışa benzer bir çıkış üretir:

├── jest@26.0.1

Bağımlılıkları temizleme

Artık bir pakete ihtiyacınız yoksa paketi kaldırın. Bir bağımlılığı kaldırmak projenizin temiz kalmasını sağlar ve alandan tasarruf etmenizi sağlar. Bu temizleme özellikle Angular, React veya Vue gibi Tek Sayfalı Uygulamalar (SPA' lar) için önemlidir. Bu uygulamalar, kodu tarayıcıya sunulan bir dosyaya paketleyip sıkıştırır. Dosya ne kadar büyük olursa, yüklenmesi o kadar uzun sürer ve bu da kullanıcıları caydırabilir.

İhtiyacınız olmayan bağımlılıkları temizlemenin iki yolu vardır:

  • Kaldırma: Paketi kaldırmak için komutunu npm uninstall <name of dependency>çalıştırın. Bu komut, paketi bildirim dosyasından package.json ve node_modules klasöründen kaldırır.
  • Prune: tüm listelenmemiş bağımlılıkları öğesinden node_moduleskaldırmak için kullanınnpm prune. Ayıklama, her biri için kaldırmayı çalıştırmadan birden çok bağımlılığı kaldırmak istediğinizde yararlıdır. Ayıklamak için:
    1. içindeki bağımlılıklardan veya devDependencies öğesinden girdileri package.jsonsilin.
    2. run npm prune.