SemVer バージョン範囲テスター

このツールについて

npm 形式のバージョン範囲と、1 行に 1 つのバージョンを入力して、手元の一覧を照合します。内蔵の node-semver 7.8.5 を loose: false で使用し、一致する有効な版、範囲外の有効な版、無効な入力を区別します。正規化した比較式のグループ、一致した版の昇順一覧、その一覧の最小・最大バージョンを確認できます。同じグループの比較式は AND、グループ間は OR です。プレリリーススイッチで includePrerelease を明示的に切り替えます。処理はブラウザー内で完結し、パッケージレジストリへの問い合わせやパッケージコードの実行は行いません。

npm SemVer の具体例

{
  "range": "^0.2.3",
  "versions": "0.2.3\n0.2.9\n0.3.0\n0.2.4-beta.1",
  "includePrerelease": false
}

{
  "matches": [
    "0.2.3",
    "0.2.9"
  ],
  "unmatched": [
    "0.3.0",
    "0.2.4-beta.1"
  ],
  "invalid": [],
  "minimum": "0.2.3",
  "maximum": "0.2.9"
}

{
  "range": ">=1.2.3-beta.2 <1.3.0",
  "versions": "1.2.3-beta.4\n1.2.4-beta.1\n1.2.3",
  "includePrerelease": false
}

{
  "matches": [
    "1.2.3-beta.4",
    "1.2.3"
  ],
  "unmatched": [
    "1.2.4-beta.1"
  ],
  "invalid": [],
  "minimum": "1.2.3-beta.4",
  "maximum": "1.2.3"
}

{
  "range": "^1.2.3",
  "versions": "1.2.3\n1.3.0-beta.1\n2.0.0-beta.1",
  "includePrerelease": true
}

{
  "matches": [
    "1.2.3",
    "1.3.0-beta.1"
  ],
  "unmatched": [
    "2.0.0-beta.1"
  ],
  "invalid": [],
  "minimum": "1.2.3",
  "maximum": "1.3.0-beta.1"
}

{
  "range": "",
  "versions": "1.2.3+build.2\n\n1.2.3+build.1\n1.2\n01.2.3\n=1.2.3\n v1.2.4 ",
  "includePrerelease": false
}

{
  "matches": [
    "1.2.3+build.2",
    "1.2.3+build.1",
    "1.2.4"
  ],
  "unmatched": [],
  "invalid": [
    "1.2",
    "01.2.3",
    "=1.2.3"
  ],
  "minimum": "1.2.3+build.2",
  "maximum": "1.2.4"
}

{
  "range": "<1.2.3 || >1.2.3",
  "versions": "1.2.2\n1.2.3+build.7\n1.2.4",
  "includePrerelease": false
}

{
  "matches": [
    "1.2.2",
    "1.2.4"
  ],
  "unmatched": [
    "1.2.3+build.7"
  ],
  "invalid": [],
  "minimum": "1.2.2",
  "maximum": "1.2.4"
}

よくある範囲テストの誤り

• 範囲演算子に != を使う：<1.2.3 || >1.2.3 のように 2 つの比較式グループで除外を表してください。
• 一覧にパッケージ名、latest などのタグ、カンマ区切りや不完全な版を貼り付ける：完全なバージョンを 1 行ずつ入力してください。
• プレリリースのハイフンを範囲と混同する：ハイフン範囲は 1.2.3 - 2.0.0 のように前後へ空白を置きます。
• includePrerelease がすべての境界を無視する、または ^ が 0.x と 1.x で同じだと思い込む：正規化した比較式を確認してください。
• 最大の一致入力をレジストリ検索結果、互換性保証、安全性の推奨と考える：このツールはそれらを確認しません。

制限と注意事項

• —固定した node-semver 7.8.5 を loose: false で使い、バージョンの自動補完は行いません。^、~、<、<=、>、>=、=、ハイフン範囲、x/X/*、|| に対応します。npm の厳密モードは SemVer 仕様だけの検証ではありません。バージョン行の先頭 v は許可されますが、先頭 = は範囲の比較演算子としてのみ許可され、バージョン行では無効です。範囲には部分バージョンを使えますが、一覧の各行には使えません。!= は非対応です。1.2.3 を除外する場合は <1.2.3 || >1.2.3 とします。
• —includePrerelease が無効な場合、プレリリースが一致するには、該当グループ内に同じ major.minor.patch のプレリリースを指定した比較式が必要です。有効にするとこの既定の除外を解除しますが、範囲の境界は引き続き適用されます。すべてのプレリリースが一致するわけではなく、比較式の正規化結果が変わる場合もあります。
• —範囲の上限は 2,000 文字、32 個の || グループ、空白区切りの 128 トークンです。バージョン入力は 100,000 文字、空白行を含む 1,000 物理行までです。前後の空白を除いた各バージョンは 256 文字までとし、超過した行は無効になります。範囲が無効な場合や範囲・一覧全体の上限を超えた場合はチェックを中止し、部分的な一致結果は返しません。
• —並べ替えは SemVer の優先順位に従い、正規化した一致結果にビルドメタデータを保持します。重複や異なる +build 接尾辞など、優先順位が同じ項目は入力順を保ちます。最小・最大は入力内で一致した行だけから選び、レジストリの公開版や範囲の理論上の境界を示しません。一致行がなければ両方とも null です。
• —ページと内蔵コードを読み込んだ後は、ブラウザー内でオフライン照合できます。パッケージレジストリ、インストール済みの依存ツリー、パッケージコードは参照・実行しません。一致しても API 互換性、依存解決、保守状況、安全性は保証されません。出力 JSON には入力範囲と前後の空白を除いたバージョン行が無効な行も含めて入るため、共有前に非公開情報を確認してください。コピーやダウンロード後のレポートはページでは管理できません。

よくある質問

関連ツール