版本

类型 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"

浏览器兼容性