📦

メジャーアップデートする時のpackage.jsonの書き方

2022/04/27に公開

概要

v1からv2へのメジャーアップデートを行うとします。
その時にpackage.jsonのバージョン表記を以下のように書くとスムーズです。

  • v1の最終バージョンまでアップデート:^1.x.x < 2.0.0
  • v2.0.0にアップデート:2.0.0
  • v2の最終バージョンにアップデート:2.x.x

それぞれ表記を変えた後に npm update <アップデートしたいパッケージ名> を実行すればインストールされます。インストールしたら動作確認します。

特にv1の最新版(つまりv2の1つ前)にアップデートする時の書き方にたどり着くまでに苦労しました。v1の最新版までアップデートすると、ほぼ確実にv2で廃止となるものが警告として出るはずです。この段階で警告を潰してからv2にアップデートします。
v1の最新版で警告を潰せば、v2のマイナー、バグフィックス含めたバージョンまでアップデートしてもいいかも知れませんが、私は一応v2.0.0を入れて動作チェックをしています。この辺りは好みかもです。

「いきなりv2にアップデートすると廃止メソッドとかがあった時に困るからv1の最新まで上げて警告チェックしたいけどどうやって書くんだ?」って疑問に思ったので同じ境遇の人の助けになれば!

Discussion