version

Typ String
Obligatorisch Ja
Beispiel
json
"version": "0.1"

Die Versionszeichenfolge für die Erweiterung.

Versionsformat

Die Versionszeichenfolge besteht aus 1 bis 4 Zahlen, die durch Punkte getrennt sind, zum Beispiel 1.2.3.4. Zahlen, die nicht null sind, dürfen keine führende Null enthalten. Zum Beispiel ist 2.01 nicht erlaubt; jedoch sind 0.2, 2.0.1 und 2.10 erlaubt.

Erweiterungsspeicher und Browser können durchsetzen oder warnen, wenn die Versionszeichenfolge nicht diesem Format entspricht. Sie können auch Einschränkungen für den Bereich der verfügbaren Zahlen anwenden. Zum Beispiel:

  • addons.mozilla.org (AMO) erlaubt Versionszeichenfolgen mit bis zu neunstelligen Zahlen, die diesem regulären Ausdruck entsprechen: ^(0|[1-9][0-9]{0,8})([.](0|[1-9][0-9]{0,8})){0,3}$. Außerdem wird ab Firefox 108 eine Warnung ausgegeben, wenn eine Erweiterung mit einer Versionsnummer installiert wird, die nicht diesem Format entspricht.
  • Der Chrome Web Store verlangt Zahlen zwischen 0 und 65535 und erlaubt keine komplett nullbasierten Versionszeichenfolgen. Zum Beispiel sind 0.0 oder 0.0.0.0 nicht erlaubt.

Es könnte möglich sein, eine Erweiterung zu erstellen, die bei Ausführung in einem Browser eine gültige Versionsnummer zu haben scheint, jedoch nicht den Anforderungen eines Speichers entspricht. Besonders vorsichtig sollte man bei der Entwicklung von browserübergreifenden Erweiterungen mit großen Zahlenelementen sein.

Einige Browser und Webstores können den Schlüssel version_name erkennen. Dieser Schlüssel ermöglicht es Ihnen, eine beschreibende Versionszeichenfolge bereitzustellen, die möglicherweise anstelle der Versionsnummer angezeigt wird. Zum Beispiel 1.0 beta.

Vergleich von Versionen

Um zu bestimmen, welche von zwei Erweiterungsversionen die aktuellste ist, werden die Nummern der Versionszeichenfolgen von links nach rechts verglichen. Ein fehlendes Element der Versionszeichenfolge entspricht 0. Zum Beispiel entspricht 1.0 der Version 1.0.0.0. Die erste Versionszeichenfolge mit einer Zahl, die größer ist als die entsprechende Zahl in der anderen Versionszeichenfolge, ist die aktuellste. Zum Beispiel ist 1.10 eine aktuellere Version als 1.9.

Legacy-Versionsformate

Siehe Legacy-Versionsformate für Details zu früher unterstützten Versionszeichenfolgen.

Zugreifen auf die Versionsnummer im Code

Sie erhalten die Erweiterungsversion in Ihrem JavaScript-Code mit:

js
console.log(browser.runtime.getManifest().version);

Wenn das Manifest Folgendes enthält:

json
"version": "0.1"

Sie sehen dies im Konsolenprotokoll:

"0.1"

Browser-Kompatibilität

BCD tables only load in the browser