Tentang paket dan modul npm

Registri npm berisi paket, banyak di antaranya juga merupakan modul Node, atau berisi modul Node. Baca terus untuk memahami perbedaannya dan cara interaksinya.
Tentang paket

Paket adalah file atau direktori yang dijelaskan oleh file package.json. Paket harus berisi file package.json agar dapat dipublikasikan ke registri npm. Untuk informasi selengkapnya tentang membuat file package.json, lihat "Membuat file package.json".

Paket dapat tidak memiliki cakupan atau memiliki cakupan untuk pengguna atau organisasi, dan paket yang memiliki cakupan dapat bersifat privat atau publik.
 

Tentang format paket

Paket adalah salah satu dari berikut ini:

a) Folder yang berisi program yang dijelaskan oleh file package.json.
b) Tarball yang di-gz yang berisi (a).
c) URL yang mengarah ke (b). d) <nama>@<versi> yang dipublikasikan pada registri dengan (c).
e) <nama>@<tag> yang mengarah ke (d).
f) <nama> yang memiliki tag terbaru yang memenuhi (e).
g) Url git yang, ketika dikloning, menghasilkan (a).

 

 Format URL git paket npm

URL Git yang digunakan untuk paket npm dapat diformat dengan cara berikut:

• git://github.com/user/project.git#commit-ish
• git+ssh://user@hostname:project.git#commit-ish
• git+http://user@hostname/project/blah.git#commit-ish
• git+https://user@hostname/project/blah.git#commit-ish

Commit-ish dapat berupa tag, sha, atau cabang apa pun yang dapat diberikan sebagai argumen untuk git checkout. Commit-ish default adalah HEAD.

Menginstal paket apa pun secara langsung dari git tidak akan menginstal submodul atau ruang kerja git.

 

 Tentang modul

Modul adalah berkas atau direktori apa pun dalam direktori node_modules yang dapat dimuat oleh fungsi require() Node.js.

Agar dapat dimuat oleh fungsi require() Node.js, modul harus berupa salah satu dari berikut ini:

• Folder dengan berkas package.json yang berisi kolom "main".
• Berkas JavaScript.

Catatan: Karena modul tidak diharuskan memiliki berkas package.json, tidak semua modul adalah paket. Hanya modul yang memiliki berkas package.json yang juga merupakan paket.

Dalam konteks program Node, modul juga merupakan hal yang dimuat dari berkas. Misalnya, dalam program berikut:
var req = require('request')

Variabel req merujuk pada modul permintaan yang dikembalikan oleh fungsi require().