权限申请与使用：教你正确声明和调用chrome.permissions（动态权限）——​Chrome插件开发从入门到精通系列教程​07

理解 Chrome 扩展权限类型

Chrome 扩展权限分为必选权限（Declared Permissions）和可选权限（Optional Permissions）。必选权限在manifest.json中声明，安装时一次性请求；可选权限允许在运行时按需动态请求，提升用户体验。

常用权限作用解析

• activeTab: 临时访问用户当前激活的标签页，适用于点击扩展图标后操作的场景。
• storage: 访问chrome.storageAPI 存储扩展数据，分sync（同步）和local（本地）模式。
• scripting: 动态注入或执行脚本，需搭配host_permissions指定目标网站。
• host_permissions: 声明需访问的域名或 URL 模式（如*://*.example.com/*）。

可选权限的声明方式

在manifest.json中通过optional_permissions字段声明，支持的权限类型与普通权限一致：

{
  "optional_permissions": ["activeTab", "https://*.example.com/*"]
}

动态请求权限的代码实现

使用chrome.permissions.request()在运行时触发权限请求对话框。以下示例演示如何动态请求访问特定网站的权限：

const targetSite = "https://*.example.com/*";

chrome.permissions.contains(
  { origins: [targetSite] },
  (hasPermission) => {
    if (!hasPermission) {
      chrome.permissions.request(
        { origins: [targetSite] },
        (granted) => {
          if (granted) {
            console.log("权限已授予");
            // 执行依赖权限的操作
          } else {
            console.log("用户拒绝了权限");
          }
        }
      );
    }
  }
);

检查当前权限状态

通过chrome.permissions.contains()可检查扩展是否已拥有特定权限，避免重复请求：

chrome.permissions.contains(
  { permissions: ["storage"], origins: ["https://*.example.com/*"] },
  (result) => { console.log("当前权限状态:", result); }
);

移除不再需要的权限

使用chrome.permissions.remove()主动释放权限，增强用户信任：

chrome.permissions.remove(
  { origins: ["https://*.example.com/*"] },
  (removed) => { console.log("权限已移除:", removed); }
);

处理用户权限变更

监听chrome.permissions.onAdded和chrome.permissions.onRemoved事件，实时响应权限变化：

chrome.permissions.onAdded.addListener((permissions) => {
  console.log("新增权限:", permissions);
});

chrome.permissions.onRemoved.addListener((permissions) => {
  console.log("移除权限:", permissions);
});

最佳实践与审核建议

• 最小权限原则: 仅请求必要的权限，可选权限优先于必选权限。
• 明确解释用途: 在权限请求前通过 UI 说明原因（如弹窗或侧边栏提示）。
• 渐进式引导: 首次触发功能时再请求权限，而非安装时全部索要。
• 备用流程设计: 用户拒绝权限时提供降级方案（如只操作当前标签页而非全部页面）。

通过合理使用动态权限，既能满足功能需求，又能降低用户隐私顾虑，显著提高商店审核通过率。