1-node-npm-yarn-package-json

1 - Node、NPM、Yarn、そしてpackage.json

この章ではNode、NPM、Yarn、そして基本的なpackage.jsonファイルのセットアップを行います.

まず、バックエンドのJavaScriptとして使われるだけではなく、モダンなフロントエンドスタックを構築するためのツールとしても使われる、Nodeをインストールする必要があります。

macOSとWindowsバイナリ用ダウンロードページに行くか、Linuxディストリビューション用のpackage manager installations pageに行きます。

たとえば、UbuntuかDebian であれば、Nodeをインストールするために以下のコマンドを実行します。

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs

Node のバージョンは6.5.0以降であればどれでも構いません。

Nodeの標準パッケージマネージャー、npmはNodeに付属しているため、別途インストールする必要はありません。

注意: Nodeがすでにインストールされている場合、nvm(Node Version Manager) をインストールし、nvmを使って最新のNodeをインストールしてください。

YarnはNPMよりも高速なもう一つのパッケージマネージャで、オフライン環境にも対応し、依存しているものをより期待通りに取得します。Yarnは2016年10月にリリースされて以来、パッケージマネージャの新たな選択肢としてJavaScriptコミュニティに急速に受け入れられつつあります。このチュートリアルではYarnを使っています。NPMを使いたい場合は、yarn addやyarn add --devなどのコマンドを、npm install --saveやnpm install --save-devなどと読み替えてください。

• インストール手順に従ってYarnをインストールします。npm install -g yarnやsudo npm install -g yarnなどでインストールすることもできます（そうです、YarnをインストールするのにNPMを使うのです。Internet ExplorerやSafariを使ってChromeをインストールするようなものですね!）

• 新しい作業用フォルダを作り、cdで移動します。

• yarn initを実行し、質問に答えると(yarn init -yで全ての質問をスキップできます)、package.jsonファイルが自動生成されます。

• console.log('Hello world')と書かれたindex.jsファイルを作ります。

• そのフォルダ内でnode .と実行します(index.jsはNodeがカレントフォルダ内で探すデフォルトのファイル名です)。"Hello world"と表示されるはずです。

node .でプログラムを実行させるのはやや低レベル寄りです。代わりにNPM/Yarnスクリプトを使ってコードを実行します。より複雑なプログラムを実行する場合でも、必ずyarn startで実行できるようにするのは、適切な抽象化になっています。

• package.json内のscriptsオブジェクトに"start": "node ."と追加します。

"scripts": {
  "start": "node ."
}

package.jsonは構文的に正しいJSONファイルでなければならないので、末尾のカンマを追加してはいけません。package.jsonファイルを手で編集する時はよく注意してください。

• yarn startと実行します。Hello worldと表示されるはずです。

• .gitignoreを作り、以下の内容を追加します。

npm-debug.log
yarn-error.log

注意: 私が作ったpackage.jsonファイル内には、各章に対してtutorial-testスクリプトがあります。このスクリプトはyarn && yarn startで各章が正しく実行されることを私自身がテストするためのものです。他のプロジェクトに使う場合は、ここは削除しても構いません。

(原文: 1 - Node, NPM, Yarn, and package.json)

次章: 2 - パッケージのインストールと使用

目次に戻る