版本

型別 String
必填
示例
json
"version": "0.1"

擴充套件的版本字串

版本格式

版本字串由 1 到 4 個數字組成,用點分隔,例如 1.2.3.4。非零數字不能包含前導零。例如,不允許使用 2.01;但是,允許使用 0.22.0.12.10

擴充套件商店和瀏覽器可能會強制執行或警告版本字串不符合此格式。它們也可能對可用數字的範圍施加限制。例如

  • addons.mozilla.org (AMO) 允許使用最多九位數字的版本字串,符合此正則表示式 ^(0|[1-9][0-9]{0,8})([.](0|[1-9][0-9]{0,8})){0,3}$。此外,從 Firefox 108 開始,如果安裝的擴充套件程式的版本號與此格式不匹配,則會提供警告。
  • Chrome Web Store 要求 數字介於 0 和 65535 之間,並且不允許使用全零擴充套件字串。例如,不允許使用 0.0 或 0.0.0.0。

在瀏覽器中執行時,可能可以建立一個版本號似乎有效的擴充套件程式,但它不符合商店的要求。在開發使用大數字元素的跨瀏覽器擴充套件時,應特別小心。

某些瀏覽器和 Web 商店可能支援 version_name 鍵。此鍵允許您提供一個描述性版本字串,該字串可能會顯示而不是版本號。例如,1.0 beta

比較版本

為了確定兩個擴充套件版本中哪個是最新版本,將從左到右比較版本字串中的數字。缺失的版本字串元素相當於 0。例如,1.0 等同於 1.0.0.0。第一個版本字串中與另一個版本字串中對應數字較大的版本是最新版本。例如,1.10 比 1.9 更新。

舊版版本格式

有關以前支援的版本字串的詳細資訊,請參閱 舊版版本格式

在程式碼中訪問版本號

您在 JavaScript 程式碼中使用以下方法獲取擴充套件版本:

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

如果 manifest 包含

json
"version": "0.1"

您在控制檯日誌中看到此資訊

"0.1"

瀏覽器相容性