Semver 範囲チェッカー

動作のしくみ

• バージョンはカンマ、スペース、改行で区切れます。latest のように有効なバージョンでないものは、黙って無視されるのではなく、別に一覧表示されます。
• 範囲は展開した形で表示されます。^1.2.0 は >=1.2.0 <2.0.0-0 で、node-semver が実際に比較に使うのはこの形です。
• npm と同様に、許可しない限りプレリリースは除外されます。デフォルトでは ^1.2.0 は 1.10.0-beta.1 を受け入れません。
• 最も高いバージョンの次のパッチ、マイナー、メジャー、rc プレリリースを算出し、バージョンがちょうど 2 つの場合はその差（major、minor、patch…）を表示します。

よくある質問

^ と ~ の違いは何ですか？

^ は、左端の 0 でない数字を変えない範囲をすべて許可します。^1.2.3 は 2.0.0 未満まで受け入れます。~ はマイナーバージョンが指定されている場合、パッチの更新だけを許可します。~1.2.3 は 1.3.0 未満まで受け入れます。npm はデフォルトで package.json に ^ を書き込みます。

^0.2.3 が 0.3.0 を受け入れないのはなぜですか？

0.x のバージョンでは、マイナー番号が破壊的変更を示すものとして扱われるからです。1.0.0 より前はセマンティックバージョニングが安定性を約束しないため、^0.2.3 は >=0.2.3 <0.3.0 を意味します。同様に、^0.0.3 は 0.0.3 そのものしか受け入れません。

1.10.0-beta.1 が ^1.2.0 に拒否されるのはなぜですか？

npm は、範囲自体が同じ major.minor.patch のプレリリースを指定していない限り、プレリリースを範囲から除外します。これにより、ベータ版が誤ってインストールされるのを防ぎます。「プレリリースを含める」をオンにすると、許可した場合に範囲が何を受け入れるかを確認できます。これは npm の --include-prerelease と同じ挙動です。

loose モードは何をしますか？

=1.2.3beta のように、厳密な semver では拒否される雑なバージョンを受け入れ、どう解釈したかを表示します。この場合は 1.2.3-beta です。古いパッケージや一部のタグはこうしたバージョンを使っています。strict モードは仕様が認める形式です。

別の呼び方

• semver 範囲 確認
• semver チェッカー
• npm バージョン 範囲
• キャレット チルダ 違い
• semver satisfies
• セマンティックバージョニング 計算