ワイルドカード範囲 (x, *, 1.x, 1.2.*)

ワイルドカード文字(x、*、または省略部分)を使用して、メジャーまたはマイナーライン内の任意のバージョンにマッチします。1.xは>=1.0.0 <2.0.0と同等です。

Wildcard Ranges

詳細な説明

ワイルドカード(X-Range)構文

ワイルドカードを使用すると、xX*、またはバージョンコンポーネントの省略で「このパターンにマッチする任意のバージョン」を表現できます。

構文バリエーション

以下はすべて同じ範囲を表現する同等の方法です:

パターン 同等 展開形
* (任意) >=0.0.0
1.x 1.* >=1.0.0 <2.0.0
1.2.x 1.2.* >=1.2.0 <1.3.0
1 1.x.x >=1.0.0 <2.0.0
1.2 1.2.x >=1.2.0 <1.3.0

仕組み

xまたは*文字は「この位置の任意の値」を意味します。範囲は以下のようになります:

  • 下限: ワイルドカードを0に置換
  • 上限: 最初のワイルドカードののコンポーネントをインクリメント

ワイルドカードの使い時

ワイルドカードは以下で最も読みやすくなります:

  1. ピア依存関係: "react": "18.x" — 明確に「任意のReact 18」
  2. エンジン要件: "node": "20.x" — 任意のNode 20リリース
  3. モノリポワークスペース範囲: 「同じメジャー」を素早く表現

ユースケース

メジャーライン内の任意のバージョンが許容されるピア依存関係、エンジン制約、またはワークスペース設定で幅広い互換性要件を表現する場合。

試してみる — Semver Calculator

フルツールを開く