Podręcznik

Node Package Manager

Node Package Manager (npm) to popularny system obsługi pakietów dla środowiska Node.js, składający się z trzech elementów:

  • rejestru pakietów przeznaczonych dla Node.js,
  • strony internetowej, służącej m.in. do wyszukiwania i udostępniania takich pakietów,
  • oprogramowania przeznaczonego do użytku w wierszu poleceń (ang. Command Line Interface), służącego do pobierania i obsługi takich pakietów.

Oprogramowanie npm zwykle instalowane jest razem ze środowiskiem Node.js, na przykład przy użyciu Node Version Manager (nvm). Instrukcje dotyczące instalacji npm można znaleźć w dokumentacji.

Dokumentacja npm:
https://docs.npmjs.com/


Pakiety vs. moduły

W Node.js moduł (ang. module) oznacza pojedynczy plik, nadający się do zaimportowania (w szczególności: plik .js).

Każdy pakiet (ang. package) systemu npm zawiera jeden lub więcej powiązanych ze sobą modułów. Może mieć postać folderu, zawierającego pliki .js; może też zawierać pojedynczy plik .js. Pakiet musi zawierać m.in. plik package.json (opisany w dalszej części tego rozdziału).

Przykładowa struktura pakietu

Dokumentacje Node.js i npm wydają się niespójne w kwestii rozumienia słowa „moduł”. W dokumentacji Node.js można znaleźć następujące stwierdzenie:

In Node.js, each file is treated as a separate module.

Natomiast w dokumentacji npm – następujące:

A module is any file or directory in the node_modules directory that can be loaded by the Node.js require() function.