Node.jsのソースを表示

[[Category:開発]]
[[en:Node.js]]
[[zh-hans:Node.js]]
[http://nodejs.org/ Node.js] は便利なライブラリが組み合わされた JavaScript 実行環境です。[https://code.google.com/p/v8/ Google の V8 エンジン] を使用してブラウザの外でコードを実行します。イベント駆動型のノンブロッキング I/O モデルを採用しているため、リアルタイムなウェブアプリケーションに適しています。

== インストール ==

{{Pkg|nodejs}} パッケージを[[インストール]]します。LTS 版もあります:
* {{Pkg|nodejs-lts-fermium}} - 14.X バージョンの場合
* {{Pkg|nodejs-lts-erbium}} - 12.X バージョンの場合

=== 別のインストール方法 ===

様々なバージョンの {{Pkg|nodejs}} を動作させる必要があったり、または動作させることを望むことは珍しいことではありません。node ユーザーの間で推奨されている方法は [https://github.com/creationix/nvm NVM] (Node Version Manger) の使用です。{{AUR|nvm}} を使うことで簡単にインストールすることができます。

これをシェルの起動ファイルに追加することで設定できます:

 # Set up Node Version Manager
 source /usr/share/nvm/init-nvm.sh

使用方法はプロジェクトの github にまとめられていますが、要するに次を実行するだけです:

 $ nvm install 8.0
 Downloading and installing node v8.0.0...
 [..]
 
 $ nvm use 8.0
 Now using node v8.0.0 (npm v5.0.0)

{{AUR|nvm}} を使う場合、以前は AUR の {{ic|nodejs-fake}} パッケージを使うことが推奨されていましたが、これは現在、[https://lists.archlinux.org/pipermail/aur-requests/2018-January/021828.html 削除]されています。推奨される方法は、マニュアル {{man|8|pacman|TRANSACTION OPTIONS (APPLY TO -S, -R AND -U)}} にあるように、{{ic|1=--assume-installed nodejs=<version>}} を使うことです。

ディレクトリに、.nvmrc ファイルがあるたびに、`nvm use` を自動的に実行したい場合は、{{ic|~/.bashrc}} に[https://stackoverflow.com/a/50378304 以下]を追加してください。

== Node Packaged Module ==

[https://www.npmjs.org/ npm] は node.js の公式パッケージマネージャです。{{Pkg|npm}} パッケージでインストールできます。

=== npm でパッケージを管理 ===

==== パッケージのインストール ====

全てのパッケージは次のコマンドでインストールできます:

 $ npm install packageName

上のコマンドでパッケージがカレントディレクトリの {{ic|node_modules}} に、実行ファイルが {{ic|node_modules/.bin}} にインストールされます。

システム全体にインストールするには {{ic|-g}} スイッチを使います:

 # npm -g install packageName

デフォルトでは、上記のコマンドでパッケージは {{ic|/usr/lib/node_modules/npm}} にインストールされるため、実行するのに管理者権限が必要になります。

ユーザー個別にインストールする場合、別のローカルフォルダを使うように {{ic|npm}} を設定することができます。様々な方法で設定できます:

* 手動で {{ic|--prefix}} コマンドラインフラグを使う (例: {{ic|npm -g install packageName --prefix ~/.node_modules}})。
* {{ic|npm_config_prefix}} 環境変数を使う。
* ユーザーの設定ファイル {{ic|~/.npmrc}} を使う。

1番目の方法は推奨されていません。インストールした場所を覚えておく必要があり、操作を行う度にパラメータを指定しなくてはならないためです。

2番目の方法を使う場合、シェルの設定ファイル (例: {{ic|.bash_profile}}) に以下の行を追加してください:

 PATH="$HOME/.node_modules/bin:$PATH"
 export npm_config_prefix=~/.node_modules

変更を適用するために、一度ログアウトしてからログインしなおすか、シェルを再起動してください。

3番目の方法では以下のコマンドを使います:

 $ npm config edit

{{ic|prefix}} オプションを探して、適当な場所に設定してください:

 prefix=~/.node_modules

行頭の {{ic|;}} は忘れずに削除してください。そのままではコメントとして認識されてしまいます。上記の設定をしたら、シェルの設定ファイル (例: {{ic|.bash_profile}}) に実行ファイルの場所を追加します:

 export PATH="$HOME/.node_modules/bin:$PATH"

変更を適用するために、一度ログアウトしてからログインしなおすか、シェルを再起動してください。

===== Allow user-wide installations =====

To allow ''global'' package installations for the current [[ユーザー]], set the {{ic|npm_config_prefix}} [[環境変数#ユーザー毎|環境変数]] This is used by both npm and [https://yarnpkg.com/en/ yarn].

{{hc|~/.profile|2=
PATH="$HOME/.local/bin:$PATH"
export npm_config_prefix="$HOME/.local"
}}

Re-login or ''source'' to update changes.

You can also specify the {{ic|--prefix}} parameter for {{ic|npm install}}. However, this is '''not''' recommended, since you will need to add it every time you install a global package.

 $ npm -g install packageName --prefix ~/.local

Another method to do the same is to edit {{ic|prefix}} field in {{ic|$HOME/.npmrc}} file to change the install location permanently.

{{Note|The last method is specific to ''npm'' only.}}

==== パッケージのアップデート ====

パッケージをアップデートするには次を実行:

 $ npm update packageName

グローバルにインストールしたパッケージ ({{ic|-g}}) の場合:

 # npm update -g packageName

{{Note|グローバルにパッケージをインストールしたときは管理者権限が必要なので注意してください。}}

===== 全てのパッケージをアップデート =====

場合によっては、全てのパッケージをアップデートしたいと思うかもしれません。ローカルでもグローバルでも可能です。packageName を抜いて {{ic|npm}} を実行すると全てのパッケージがアップデートされます:

 $ npm update

またはグローバルにインストールしたパッケージをアップデートするには {{ic|-g}} フラグを追加:

 # npm update -g

==== パッケージの削除 ====

{{ic|-g}} スイッチを使ってインストールしたパッケージを削除するには次のコマンドを使用:

 # npm -g uninstall packageName

{{Note|グローバルにパッケージをインストールしたときは管理者権限が必要なので注意してください。}}

ローカルパッケージを削除するときはスイッチを省いて実行:

 $ npm uninstall packageName

==== パッケージの一覧表示 ====

グローバルにインストールしたパッケージのツリービューを表示するには次を使用:

 $ npm -g list

場合によってツリーは深くなりすぎることがあります。トップレベルのパッケージだけを表示するには:

 $ npm list --depth=0

アップデートが必要な古いパッケージだけを表示するには:

 $ npm outdated

=== pacman でパッケージを管理 ===

[[Arch User Repository]] には {{ic|nodejs-packageName}} という名前で node.js のパッケージがいくつか存在します。

== トラブルシューティング ==

=== node-gyp エラー ===


次のようなエラーの場合 {{ic|gyp WARN EACCES user "root" does not have permission to access the ... dir}} は {{ic|--unsafe-perm}} オプションが役立つ場合があります。

 # npm install --unsafe-perm -g node-inspector

=== エラー Cannot find module ...  ===

npm 5.x.x 以降、package-lock.json ファイルは package.json とともに生成されます。2つのファイルが異なるパッケージバージョンを参照している場合、競合が発生する可能性があります。この問題を解決する一時的な方法は次の通りです:
 $ rm package-lock.json
 $ npm install

ただし、npm 5.1.0 以降で修正されています。詳細については、以下を参照してください:

[https://github.com/npm/npm/pull/17508 missing dependencies]

== 参考資料 ==

{{Pkg|nodejs}} や公式のパッケージマネージャである [https://www.npmjs.org/ npm] の詳細情報は以下の資料を参照してください:

* [https://nodejs.org/ja/docs/ Node.js ドキュメント]
* [https://docs.npmjs.com/ NPM ドキュメント]
* IRC チャンネル #node.js on irc.freenode.net

{{TranslationStatus|Node.js|2021-08-03|689079}}