Chrome扩展offscreen用WORKERS报错，与文档不符如何解决？

错误原因 #

WORKERS 作为Offscreen文档的Reason枚举值，是Chrome 116版本才新增的API选项。你遇到的错误，本质是当前运行的Chrome版本低于116，旧版本的Chrome Offscreen API还未支持这个枚举值，导致与你查看的最新版官方文档内容不匹配。

修复步骤 #

• 升级Chrome版本：将Chrome浏览器升级到116或更高版本，即可正常使用WORKERS作为reason参数值。
• 兼容旧版本的替代方案：如果需要适配低版本Chrome，可改用当前环境支持的Reason值（比如DOM_PARSER或TESTING，根据实际业务场景选择），示例代码如下：

chrome.offscreen.createDocument({
  url: chrome.runtime.getURL('off_screen.html'),
  reasons: ['DOM_PARSER'],
  justification: 'reason for needing the document',
});

• 配置扩展最低版本要求：在扩展的manifest.json中设置minimum_chrome_version为"116"，避免低版本Chrome用户安装运行时出现类似错误：

{
  "manifest_version": 3,
  "minimum_chrome_version": "116",
  // 其他配置项
}

内容的提问来源于stack exchange，提问作者Cemstrian