仕組みと内部処理
npm 自身が利用している標準 `semver` パッケージをブラウザ上で直接駆動し、範囲式(`^`, `~`, ハイフン範囲, `||` 和集合)をパースして候補リストを判定(プレリリース含有オプション対応)。さらに `semver.compare`、`semver.diff`、`semver.inc` の結果もリアルタイム表示します。
使い方ステップ
`^1.2.0` や `>=1.4.0 <2.0.0` のような npm バージョン範囲式を入力します。
検証したい候補バージョン一覧(改行またはカンマ区切り)を貼り付け、必要に応じてプレリリースを含めるか切り替えます。
正規化された範囲境界、最大一致バージョン(`maxSatisfying`)、各候補の PASS / 除外理由を確認します。
下部カードで2つの正確なバージョン同士の大小・差分を比較したり、`patch`・`minor`・`major`・`prerelease` バンプ結果を確認します。
主な機能と特長
- 本家 npm `semver` 実装による、`package.json` やロックファイルと完全一致する判定ロジック
- 任意の候補リストから `maxSatisfying` と `minSatisfying` を即座に特定
- 2バージョン並列比較で正確な差分(`major`, `minor`, `patch`, `prerelease`)を判定
- `patch`・`minor`・`major`・名前付きプレリリース(`alpha`/`beta`/`rc`)のバージョン上げ試算機能
- 外部レジストリへの通信なしで 100% クライアントサイド動作
計算ロジック・仕様・技術基準
SemVer 2.0.0 および npm node-semver の優先順位規則に準拠しており、`0.x.y` におけるキャレットの特殊挙動(`^0.2.3` は `>=0.2.3 <0.3.0` に展開)や厳格なプレリリースオプトイン判定を忠実に再現しています。
主な利用シーン
- `package.json` の `^0.14.0` が意図せず破壊的変更のある `0.15.0` を許容してしまわないか事前確認
- `engines.node` 変更前に `>=18.0.0 <20.0.0 || ^20.11.0` のような複雑な複合範囲をテスト
- CI/CD リリースのドライラン中に次のプレリリースタグ(`1.4.2` ➔ `1.4.3-beta.0` 等)を確認
- `1.5.0-rc.1` と `1.5.0` などのバージョン前後関係を客観的に判定
入出力の例・エッジケース
Zero-Major Caret Behavior
Range: ^0.2.3 | Candidates: 0.2.9, 0.3.0
Matches: 0.2.9 (maxSatisfying) | Excluded: 0.3.0
In `0.x.y`, caret locks the minor digit because breaking changes happen in minor bumps.
Prerelease Precedence
Left: 1.4.2 | Right: 1.5.0-rc.1
1.4.2 is older than 1.5.0-rc.1 (diff: premajor/preminor)
Prerelease comes before `1.5.0` final, after `1.4.2`.
仕様上の制限・精度に関するご注意
- • SemVer 2.0.0 / npm 構文を評価します。Python の PEP 440(`~=`)や Cargo 固有の特殊仕様については手動での読み替えが必要です。
- • オフラインプライバシー保護のため、リモートの npm レジストリへの問い合わせは行いません。
ブラウザ内ローカル処理とプライバシー保護
一般的なWebツールは文書やメディアを外部サーバーへ送信します。SemVer バージョン範囲チェッカー&npm バンプ計算ツール はお使いのブラウザタブ内のみで完結します:
入力テキストやファイルは端末内で処理され、外部の処理サーバーへアップロードされません。
作業内容や貼り付けたデータを保存・記録しません(通常の静的配信CDNリクエストのみ発生します)。
作業データはタブ内のメモリ上のみに保持され、リセットまたはタブを閉じると破棄されます。
よくある質問 (FAQ)
`^1.2.0` がデフォルトで `1.5.0-alpha.1` にマッチしないのはなぜですか?
npm SemVer の仕様上、プレリリース版は同じ `[major, minor, patch]` タプルが範囲式に明示されているか、プレリリース含有モードを明示的にオンにしない限り範囲比較の対象から除外されるためです。
`~1.2.3`(チルダ)と `^1.2.3`(キャレット)の違いは何ですか?
チルダ `~1.2.3` はパッチバージョンのみの更新(`<1.3.0`)を許可し、キャレット `^1.2.3` はマイナーおよびパッチバージョンの更新(`<2.0.0`)を許可します。
`||` を使った複数範囲の結合表現にも対応していますか?
はい。`^16.0.0 || ^18.0.0` のような和集合範囲も `semver.validRange` 経由でネイティブに評価できます。
末尾のビルドメタデータ(`+build.42`)はバージョンの大小比較に影響しますか?
いいえ。SemVer 2.0.0 §10 の規定により、ビルドメタデータはバージョンの優先順位・大小比較には影響しません。