Web扩展manifest.json中Storage权限无效，Firefox临时加载报错求助

我来帮你排查这个问题——你已经在manifest.json里添加了"storage"权限但还是遇到ReferenceError: storage is not defined，大概率是API调用方式或扩展上下文的问题，试试下面这些解决措施：

• 检查API调用的命名空间：storage并不是全局可用的变量，它属于浏览器扩展API的命名空间下。Firefox支持两种合法的调用方式：

  • 标准的browser命名空间（推荐）：比如调用本地存储应该写browser.storage.local.set({key: value})或者browser.storage.local.get("key")
  • 兼容Chrome的chrome命名空间：也可以用chrome.storage.local.set(...)，Firefox同样支持这种写法
    如果你直接写storage.local.set()，浏览器自然会找不到这个变量。

• 确认扩展脚本的上下文：确保你是在扩展的合法上下文里调用storage API——比如background脚本、content脚本、popup脚本，而不是在普通网页的脚本（比如注入到页面的非content脚本）里调用，后者没有扩展权限。

• 重新加载临时扩展：修改manifest.json后，Firefox不会自动刷新临时加载的扩展。你需要打开about:debugging页面，找到你的扩展，点击「重新加载」按钮，确保新的权限配置生效。

• 验证manifest.json的格式正确性：检查permissions数组的位置和拼写，避免语法错误：

  {
    "manifest_version": 2, // 或者3，根据你的扩展版本选择
    "name": "你的扩展名",
    "version": "1.0",
    "permissions": [
      "storage"
    ],
    // 其他扩展配置...
  }
  

  确保"storage"是字符串且在permissions数组内，没有逗号遗漏、引号不匹配这类低级错误。

• 测试最小化案例排除干扰：如果上面的步骤都没用，试试创建一个极简扩展来定位问题：

  1. 新建文件夹，里面放manifest.json（包含storage权限）和一个background.js
  2. background.js里写简单的测试代码：

     browser.storage.local.set({test: "hello"}).then(() => {
       console.log("存储成功");
       browser.storage.local.get("test").then(result => {
         console.log("获取到的值：", result.test);
       });
     });
     

  3. 重新加载这个极简扩展，查看控制台是否正常输出。如果正常，说明问题出在你原扩展的其他代码里。

• 检查Manifest版本的兼容性：如果是Manifest V3，确保Firefox版本在91及以上（Firefox 91开始正式支持V3），同时V3里的service worker替代了V2的background页面，调用API的方式和V2一致，但要确保service worker能正常加载。

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