Legacy-Version-Formate

Eine Versionszeichenfolge besteht aus einem oder mehreren Versionsbestandteilen, die durch Punkte getrennt sind.

Jeder Versionsbestandteil wird als eine Sequenz von vier Teilen analysiert: <number-a><string-b><number-c><string-d>. Jeder der Teile ist optional. Zahlen sind ganze Zahlen in Basis 10 (können negativ sein), und Zeichenfolgen sind nicht-numerische ASCII-Zeichen.

Hier sind einige Beispiele für gültige Versionsbestandteile:

• 0 (wie in 1.0): <number-a>=0
• 5a (wie in 1.5a): <number-a>=5, <string-b>=a
• 5pre4 (wie in 3.5pre4): <number-a>=5, <string-b>=pre, <number-c>=4
• * (wie in 1.0.*): <string-b>=*

Einige spezielle Parsing-Regeln werden zur Wahrung der Abwärtskompatibilität und Lesbarkeit angewendet:

• Wenn der Versionsbestandteil ein einzelner Stern ist, wird er als unendlich große Zahl interpretiert: 1.5.0.* ist dasselbe wie 1.5.0.(unendlich)
• Wenn string-b ein Pluszeichen ist, wird number-a um eins erhöht, um mit dem Firefox 1.0.x-Versionsformat kompatibel zu sein: 1.0+ ist dasselbe wie 1.1pre

Der Grund für die Aufteilung eines Versionsbestandteils in eine Sequenz von Zeichenfolgen und Zahlen liegt darin, dass beim Vergleichen von Versionsbestandteilen die numerischen Teile als Zahlen verglichen werden, zum Beispiel '1.0pre1' < '1.0pre10', während die Zeichenfolgen byteweise verglichen werden. Siehe den nächsten Abschnitt für Details, wie Versionen verglichen werden.

Ab Firefox 108 löst die Verwendung dieser Versionszeichenfolge bei der Installation einer Web-Erweiterung eine Warnung aus.

Wenn zwei Versionszeichenfolgen verglichen werden, werden ihre Versionsbestandteile von links nach rechts verglichen. Ein leerer oder fehlender Versionsbestandteil entspricht 0.

Wenn an irgendeinem Punkt ein Versionsbestandteil einer Versionszeichenfolge größer ist als der entsprechende Versionsbestandteil einer anderen Versionszeichenfolge, dann ist die erste Versionszeichenfolge größer als die andere.

Andernfalls sind die Versionszeichenfolgen gleich. Da fehlende Versionsbestandteile so behandelt werden, als wären sie 0, sind diese Versionszeichenfolgen gleich: 1, 1.0, 1.0., 1.0.0 und sogar 1.0...

Versionsbestandteile werden ebenfalls von links nach rechts verglichen; Teile A und C werden als Zahlen verglichen, während Teile B und D byteweise verglichen werden. Ein vorhandener Zeichenfolgenteil ist immer kleiner als ein nicht vorhandener Zeichenfolgenteil (1.6a ist kleiner als 1.6).

1.-1
< 1 == 1. == 1.0 == 1.0.0
< 1.1a < 1.1aa < 1.1ab < 1.1b < 1.1c
< 1.1pre == 1.1pre0 == 1.0+
< 1.1pre1a < 1.1pre1aa < 1.1pre1b < 1.1pre1
< 1.1pre2
< 1.1pre10
< 1.1.-1
< 1.1 == 1.1.0 == 1.1.00
< 1.10
< 1.* < 1.*.1
< 2.0