Manifest V3浏览器扩展如何获取永久主机权限实现内容脚本自动注入？

首先纠正你的误解：通过optional_host_permissions申请到的主机权限是永久生效的，并非临时权限——只要用户同意，权限会一直保留，直到用户手动在扩展管理页移除权限或卸载扩展，完全满足你的需求。

以下是Manifest V3下的完整实现步骤：

1. 配置manifest.json #

在清单中声明可选主机权限、必要的核心权限，同时确保扩展有可触发用户交互的入口（比如浏览器工具栏图标）：

{
  "manifest_version": 3,
  "name": "你的扩展名称",
  "version": "1.0",
  "action": {
    "default_popup": "popup.html"
  },
  // 声明需要申请的目标页面权限
  "optional_host_permissions": ["https://*.targetsite.com/*"],
  // 动态注入/注册内容脚本、存储状态需要的权限
  "permissions": ["scripting", "storage"]
}

2. 触发权限请求（用户交互触发） #

必须通过用户主动操作（比如点击popup内的按钮）触发权限请求，这是Chrome的安全限制，无法自动弹出权限申请。示例代码如下：

popup.html（用户交互入口） #

<!DOCTYPE html>
<html>
<head>
  <style>button {padding: 8px 16px;}</style>
</head>
<body>
  <button id="grant-btn">启用扩展功能</button>
  <script src="popup.js"></script>
</body>
</html>

popup.js（权限请求逻辑） #

document.getElementById('grant-btn').addEventListener('click', async () => {
  // 请求预先声明的可选主机权限
  const isGranted = await chrome.permissions.request({
    origins: chrome.runtime.getManifest().optional_host_permissions
  });

  if (isGranted) {
    // 权限获批后，注册永久生效的内容脚本
    await chrome.scripting.registerContentScripts([{
      id: "auto-inject-script",
      matches: chrome.runtime.getManifest().optional_host_permissions,
      js: ["content-script.js"],
      runAt: "document_start" // 根据需求调整注入时机
    }]);

    // 存储权限状态，方便扩展重启后自动校验
    await chrome.storage.local.set({hasHostPermission: true});
    window.close();
  } else {
    alert('权限申请被拒绝，无法启用扩展功能');
  }
});

3. 扩展重启时自动确保内容脚本生效 #

为了避免扩展重启后内容脚本注册丢失（极端场景下可能发生），在background脚本中添加启动校验逻辑：

background.js（自动校验逻辑） #

async function checkAndRegisterContentScript() {
  const {hasHostPermission} = await chrome.storage.local.get('hasHostPermission');
  
  if (hasHostPermission) {
    // 检查内容脚本是否已注册
    const existingScripts = await chrome.scripting.getRegisteredContentScripts();
    const isScriptRegistered = existingScripts.some(script => script.id === "auto-inject-script");

    if (!isScriptRegistered) {
      // 重新注册内容脚本
      await chrome.scripting.registerContentScripts([{
        id: "auto-inject-script",
        matches: chrome.runtime.getManifest().optional_host_permissions,
        js: ["content-script.js"],
        runAt: "document_start"
      }]);
    }
  }
}

// 扩展启动时触发校验
chrome.runtime.onStartup.addListener(checkAndRegisterContentScript);
// 扩展首次安装时触发校验
chrome.runtime.onInstalled.addListener(checkAndRegisterContentScript);

关键说明 #

• 权限获批后，内容脚本会自动注入所有匹配的目标页面，无需用户再次操作，完全符合你的需求。
• 权限请求必须绑定用户交互（如点击按钮），这是浏览器的强制安全规则，无法绕过。
• 动态注册的内容脚本是永久生效的，除非用户手动移除权限或卸载扩展。

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