Semver-Prüfer
Prüfe, vergleiche und sortiere semantische Versionen und teste sie mit npm-Bereichen wie ^1.2.0, ~2.4, >=1.0.0 <2.0.0, 1.x oder 1.2.3 - 2.3.4. Der Prüfer folgt den Regeln von Semantic Versioning 2.0.0 für Vorabversionen und Build-Metadaten sowie denselben Bereichsregeln wie das semver-Paket von npm, zeigt die Erweiterung eines Bereichs an und findet die höchste Version, die dazu passt.
Häufig gestellte Fragen
Was macht der Prüfer?
Er analysiert jede eingegebene Version, gibt an, ob sie eine gültige semantische Version ist, sortiert die gültigen Versionen und nennt die höchste. Wenn du einen Bereich eingibst, zeigt er, welche Versionen dazu passen und welche davon die höchste ist. Bei genau zwei Versionen gibt er auch an, welche höher ist.
Was bedeutet ^1.2.3?
Das Caret erlaubt Änderungen, die die erste Zahl ungleich null nicht ändern. ^1.2.3 bedeutet >=1.2.3 <2.0.0, ^0.2.3 bedeutet >=0.2.3 <0.3.0 und ^0.0.3 bedeutet nur 0.0.3. Das ist die Standardeinstellung von npm beim Installieren eines Pakets.
Was bedeutet ~1.2.3?
Die Tilde erlaubt Patch-Updates: ~1.2.3 bedeutet >=1.2.3 <1.3.0. Bei nur einer Hauptversion bedeutet ~1 >=1.0.0 <2.0.0. Verwende sie, wenn du Fehlerbehebungen, aber keine neuen Minor-Funktionen möchtest.
Welche Bereichssyntaxen werden unterstützt?
Vergleichsoperatoren (<, <=, >, >=, =), Caret- und Tilde-Bereiche, X-Bereiche wie 1.x, 1.2.* und *, unvollständige Versionen wie 1.2, Bindestrich-Bereiche wie 1.2.3 - 2.3.4, mehrere durch Leerzeichen getrennte Vergleichsoperatoren, die alle zutreffen müssen, sowie durch || getrennte Alternativen.
Wie werden Vorabversionen verglichen?
Eine Vorabversion wie 1.0.0-beta.2 ist niedriger als die Version 1.0.0. Die Kennungen der Vorabversion werden einzeln verglichen: Zahlen numerisch, Text alphabetisch, und eine Zahl ist immer niedriger als Text. Daher gilt 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Warum erfüllt 2.0.0-beta nicht ^1.2.0?
Nach npm erfüllt eine Vorabversion einen Bereich nur dann, wenn einer der Vergleichsoperatoren des Bereichs eine Vorabversion mit derselben Haupt-, Neben- und Patch-Version nennt. So werden instabile Versionen nicht versehentlich einbezogen. Aktiviere „Vorabversionen einbeziehen“, damit sie wie normale Versionen berücksichtigt werden. Wie in npm schließen dann auch die unteren Grenzen unvollständiger und Bindestrich-Bereiche Vorabversionen ein.
Was ist die Bereichserweiterung?
Der Prüfer zeigt den Bereich als einfache Vergleichsoperatoren an, für die er steht, zum Beispiel ^1.2.3 = >=1.2.3 <2.0.0-0. Das Suffix -0 bedeutet, dass die Grenze auch Vorabversionen von 2.0.0 ausschließt, genau wie es das semver-Paket von npm schreibt.
Werden Build-Metadaten verglichen?
Nein. Semantic Versioning ignoriert Build-Metadaten, also den Teil nach einem Pluszeichen, beim Vergleich. Daher sind 1.0.0+build.1 und 1.0.0+build.2 gleich. Der Prüfer zeigt die Metadaten an, verwendet sie aber nicht zum Sortieren oder für Bereiche.
Werden Versionen mit einem vorangestellten v akzeptiert?
Ja. Ein vorangestelltes v wird ignoriert. Daher wird v1.2.3 als 1.2.3 gelesen, wie es auch npm macht. Versionen mit weniger als drei Zahlen, etwa 1.2, sind keine gültigen Versionen. In Bereichen funktionieren sie jedoch, wobei 1.2 jede 1.2.x-Version bedeutet.
Wie viele Versionen kann ich prüfen?
Bis zu 200 Versionen pro Anfrage, eine pro Zeile, und ein Bereich mit bis zu 1,000 Zeichen.