Semverチェッカー
セマンティックバージョンを確認、比較、並べ替えし、^1.2.0、~2.4、>=1.0.0 <2.0.0、1.x、1.2.3 - 2.3.4などのnpm形式の範囲に対して検証できます。チェッカーは、プレリリースとビルドメタデータについてSemantic Versioning 2.0.0のルールに従い、npmのsemverパッケージと同じ範囲ルールを適用します。また、範囲がどのように展開されるかを表示し、その条件を満たす最も高いバージョンを見つけます。
よくある質問
このチェッカーでは何ができますか?
入力した各バージョンを解析し、有効なセマンティックバージョンかどうかを判定して、有効なものを並べ替え、最も高いバージョンを示します。範囲を入力すると、その条件を満たすバージョンと、その中で最も高いバージョンを示します。バージョンをちょうど2つ入力した場合は、どちらが高いかも示します。
^1.2.3は何を意味しますか?
キャレットは、左端にあるゼロ以外の数値を変更しない更新を許可します。^1.2.3は>=1.2.3 <2.0.0、^0.2.3は>=0.2.3 <0.3.0を意味し、^0.0.3が許可するのは0.0.3だけです。パッケージをインストールするときのnpmのデフォルトです。
~1.2.3は何を意味しますか?
チルダはパッチ更新を許可します。~1.2.3は>=1.2.3 <1.3.0を意味します。メジャーバージョンだけの場合、~1は>=1.0.0 <2.0.0を意味します。バグ修正は受け入れつつ、新しいマイナー機能は取り込みたくない場合に使います。
どの範囲構文に対応していますか?
比較演算子(<、<=、>、>=、=)、キャレットとチルダの範囲、X範囲(1.xなど)、1.2.*や*、1.2などの部分バージョン、1.2.3 - 2.3.4などのハイフン範囲、すべての条件を満たす必要があるスペース区切りの複数の比較演算子、||で区切られた選択肢に対応しています。
プレリリースバージョンはどのように比較されますか?
1.0.0-beta.2などのプレリリースは、リリース版1.0.0より低いバージョンです。プレリリース識別子は1つずつ比較され、数値は数値として、文字列はアルファベット順で比較されます。また、数値は常に文字列より低くなります。そのため、1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0となります。
2.0.0-betaが^1.2.0を満たさないのはなぜですか?
npmに従い、プレリリースが範囲を満たすのは、その範囲の比較条件のいずれかに、同じメジャー、マイナー、パッチバージョンのプレリリースが指定されている場合だけです。そのため、範囲に不安定なバージョンが意図せず含まれることはありません。「プレリリースを含める」を有効にすると、通常のバージョンと同様に一致するようになります。npmと同様に、その場合は部分範囲やハイフン範囲の下限にもプレリリースが含まれます。
範囲の展開とは何ですか?
チェッカーは、範囲をそれが表す単純な比較条件として表示します。たとえば、^1.2.3 = >=1.2.3 <2.0.0-0です。接尾辞-0は、上限が2.0.0のプレリリースも除外することを意味します。これはnpmのsemverパッケージが出力する形式と同じです。
ビルドメタデータは比較されますか?
いいえ。Semantic Versioningでは、比較時にプラス記号より後ろのビルドメタデータを無視するため、1.0.0+build.1と1.0.0+build.2は同じバージョンです。チェッカーはメタデータを表示しますが、並べ替えや範囲の判定には使用しません。
先頭にvが付いたバージョンも受け付けますか?
はい。先頭のvは無視されるため、v1.2.3は1.2.3として読み取られます。npmと同じ動作です。1.2など、数値が3つに満たないバージョンは有効なバージョンではありませんが、範囲内では使えます。この場合、1.2は任意の1.2.xバージョンを意味します。
何件のバージョンを確認できますか?
1リクエストにつき最大200件のバージョンを1行に1つ入力でき、範囲は最大1,000文字です。