NPM パッケージを作るときの package.json ファイルの書き方に関してのメモ

更新: 2022-03-16 / 作成: 2022-03-16

name, version フィールド

name と version フィールドは、パッケージを公開するつもりがないなら指定する必要はありません。

description プロパティは、ユーザーがこのパッケージを探しやすくするための説明文で、npm search を実行したときに表示されます。

NPM パッケージを作るときに、.npmignore に書かれたファイルはパッケージングされなくなります。 .npmignore ファイルがない場合は、.gitignore ファイルが代わりに参照されます。これらの設定にかかわらず、下記のファイルは必ずパッケージングされます。

NPM パッケージで何らかの実行コマンドを提供したいときは、bin フィールドを使用します。例えば、mycommand コマンドを提供するときは次のように記述します。

{
  // ...
  "bin": { "mycommand": "./cli.js" }
}

単独のコマンドをインストールするための NPM パッケージを作る場合は、bin フィールドのコマンド名を省略して次のように記述できます。

{
  "name": "mycommand",
  "version": "1.2.5",
  "bin": "./path/to/program.js"
}

上記の bin フィールドは次のように記述するのと同様に振舞います。

{
  // ...
  "bin": { "mycommand": "./path/to/program.js" }
}

repository フィールドでは、ソースコードの場所を示すことができます。例えば、GitHub のリポジトリで管理している場合は次のような感じ。

{
  // ...
  "repository": {
    "type": "git",
    "url": "https://github.com/maku77/myapp.git"
  }
}

npm 1.1.65 移行は、url 部分は省略して次のように書くことができます。

{
  // ...
  "repository": {
    "type": "git",
    "url": "maku77/myapp"
  }
}