NodeJS 速習チュートリアル

Node.js NPM

1. NPM とは？

NPM は、Node.js の パッケージマネージャー（Package Manager） です。
https://www.npmjs.com/  では、数千もの無料パッケージがホストされており、誰でもダウンロードして利用できます。

NPM プログラムは Node.js をインストールする際に一緒にマシンへインストールされます。
つまり、Node.js がインストールされていれば、すでに NPM を使う準備は整っています。

2. パッケージ (Package) とは？

Node.js における「パッケージ」とは、特定の モジュール を動かすために必要なすべてのファイルが含まれた集合体のことです。
モジュールとは、プロジェクトにインポートして利用できる JavaScript のライブラリを指します。

3. パッケージのインストール（ダウンロード）

パッケージのダウンロードは非常に簡単です。
コマンドラインインターフェース（CLI）を開き、NPM に対して目的のパッケージをダウンロードするよう命令するだけです。

ここでは、文字列を大文字に変換する upper-case というパッケージを例に説明します。

パッケージのインストール実行:

C:\Users\Your Name>npm install upper-case

これで最初のパッケージのインストールが完了しました。
NPM は自動的に node_modules という名前のフォルダを作成し、その中にパッケージを配置します。
今後インストールするすべてのパッケージも、このフォルダの中に保存されます。

プロジェクトのフォルダ構造は以下のようになります：
C:\Users\My Name\node_modules\upper-case

4. パッケージの使用方法

パッケージがインストールされたら、すぐにコード内で使用できます。
他のモジュールと同様に、require() を使って upper-case パッケージを読み込みます。

let uc = require('upper-case');

以下は、出力される "Hello World!" を大文字に変換してレスポンスを返す HTTP サーバーの例です。

実装例: demo_uppercase.js

let http = require('http');
let uc = require('upper-case'); // インストールしたパッケージをインポート

http.createServer(function (req, res) {
  res.writeHead(200, {'Content-Type': 'text/html'});
  
  // upperCase 関数を使用して文字列を変換
  res.write(uc.upperCase("Hello World!")); 
  res.end();
}).listen(8080);

このコードを demo_uppercase.js という名前で保存し、実行します。

ファイルの実行:

C:\Users\Your Name>node demo_uppercase.js

ブラウザで http://localhost:8080 にアクセスすると、大文字になった結果が表示されます。

5. グローバルパッケージ (Global Packages)

パッケージを「グローバル」にインストールすると、システム上のどこからでもコマンドラインツールとして利用できるようになります。
これは主に CLI ツールやユーティリティに使用されます。

グローバルインストールのコマンド:

npm install -g パッケージ名

例: http-server をグローバルにインストールする場合

npm install -g http-server

インストール後は、どのディレクトリからでも直接コマンドを実行できます。

http-server

注意: システムによっては、グローバルインストールに管理者権限（Administrator/root）が必要な場合があります。Unix 系システムでは、コマンドの前に sudo を付けて実行してください。

6. パッケージの更新

プロジェクトのパッケージを最新の状態に保つには、以下のコマンドを使用します。

特定のパッケージを更新:

npm update パッケージ名

プロジェクト内のすべてのパッケージを更新:

npm update

古いパッケージ（更新があるもの）を確認:

npm outdated

Tips: NPM 自体を最新版に更新するには、以下のコマンドを実行します：

npm install -g npm@latest

7. パッケージのアンインストール

不要になったパッケージを削除するには、uninstall コマンドを使用します。

パッケージの削除:

npm uninstall パッケージ名

グローバルパッケージの削除:

npm uninstall -g パッケージ名

パッケージを削除し、依存関係リストからも取り除く:

npm uninstall --save パッケージ名

注意:--save フラグを付けることで、package.json ファイルからも該当の依存関係が削除されます。
（※現在の NPM バージョンではデフォルトでこの挙動になりますが、明示的に指定することも一般的です）

8. まとめ

NPM は Node.js 開発におけるエコシステムの核となるツールです。

  • NPM はパッケージの管理を行い、node_modules に保存する
  • npm install でライブラリを追加し、require() で呼び出す
  • -g フラグでシステム全体のツールとして活用できる
  • update や uninstall を使い分け、プロジェクトを健全に保つ

これらをマスターすることで、世界中の開発者が共有している高度な機能を自分のアプリに即座に取り入れることが可能になります。