More than 1 year has passed since last update.

npm packageのバージョンアップデート範囲を指定したい（semver、^、~）

Last updated at 2024-01-18Posted at 2024-01-17

1. 問題

よく使うnpm package「notrealmodule 10.0.0」に新機能が追加されたので早速アップデートしたい。
でもアプリに不具合が起きるかもしれないので怖い。
package.jsonにどう書けばいいんだろ？そもそも10.0.0とは何？

npm packageを使用する環境すべて。

^をつけて、minor visionまでのみアップデートされるようにする。

package.json

  "dependencies": {
    "notrealmodule": "^10.0.0",
  }

10.0.0はsemver方式と言って、順番にmajor、minor、patchを意味する。

Sementic versioningの略。
Javascriptエコシステムで推奨されているnpm package version 管理方式。

major：変更点が多い場合。APIの互換性を持たない変更。
minor：些細な機能追加。APIの互換性を保ちつつ機能性をAPIに追加した場合。
patch：バグ修正。APIに影響なし。

しかしすべてのnpm packageがsemverを守っているわけではない。
例：typescript

package.jsonにpackageのversion更新範囲を指定することができる。
version範囲の表記方法には代表的に以下のようなものがある。

version：正確に一致。
>verison：versionより大きい。
^version：patchとminorアップデート。
~version：patchアップデート。

npm packageはsemverでversion管理をする。
package.jsonで^や~などでpackageのアップデート範囲の指定ができる。

昔は^と~の違いが分からなかったけど、今は一気にわかる。よかったね。