Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

version

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

Der Versionsstring für die Erweiterung.

Versionsformat

Der Versionsstring besteht aus 1 bis 4 durch Punkte getrennten Zahlen, zum Beispiel 1.2.3.4. Zahlen, die nicht null sind, dürfen nicht mit einer führenden Null versehen werden. Zum Beispiel ist 2.01 nicht erlaubt; jedoch sind 0.2, 2.0.1 und 2.10 erlaubt.

Erweiterungsspeicher und Browser können erzwingen oder warnen, wenn der Versionsstring nicht diesem Format entspricht. Sie können auch Einschränkungen für den numerischen Bereich anwenden. Zum Beispiel:

  • addons.mozilla.org (AMO) erlaubt Versionsstrings mit Zahlen bis zu neun Ziffern, entsprechend diesem regulären Ausdruck ^(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 diesem Format nicht entspricht.
  • Der Chrome Web Store erfordert Zahlen zwischen 0 und 65535 und erlaubt keine vollständig nullhaltigen Versionsstrings. Zum Beispiel sind 0.0 oder 0.0.0.0 nicht erlaubt.

Es kann möglich sein, eine Erweiterung zu erstellen, die beim Ausführen in einem Browser eine gültige Versionsnummer zu haben scheint, aber nicht den Anforderungen des Stores entspricht. Besonders bei der Entwicklung von Browser-übergreifenden Erweiterungen, die große Zahlenbereiche verwenden, sollte Sorgfalt walten.

Einige Browser und Web Stores können den version_name-Schlüssel erkennen. Dieser Schlüssel ermöglicht es Ihnen, einen beschreibenden Versionsstring bereitzustellen, der anstelle der Versionsnummer angezeigt werden kann. Zum Beispiel 1.0 beta.

Versionen vergleichen

Um festzustellen, welche von zwei Erweiterungsversionen die aktuellere ist, werden die Versionsstring-Zahlen von links nach rechts verglichen. Ein fehlendes Versionsstring-Element entspricht 0. Zum Beispiel ist 1.0 gleichbedeutend mit 1.0.0.0. Der erste Versionsstring mit einer größeren Zahl als die entsprechende Zahl im anderen Versionsstring ist die aktuellere. Zum Beispiel ist 1.10 eine aktuellere Version als 1.9.

Alte Versionsformate

Siehe Alte Versionsformate für Details zu zuvor unterstützten Versionsstrings.

Zugriff 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"

Sehen Sie dies im Konsolenprotokoll:

"0.1"

Browser-Kompatibilität

Siehe auch