Chrome扩展declarativeNetRequest规则为何仅拦截forms而非document？

为什么拦截规则对Forms生效但对Document无效？ #

核心原因有两点：

1. 加载机制差异：Google Docs Document页面依赖Service Worker实现离线缓存与预加载，部分初始请求会被Service Worker直接处理，绕过了常规网络请求拦截流程；而Forms页面的加载逻辑相对简单，无此类预缓存机制，规则能正常触发。
2. URL匹配细节遗漏：你当前的||docs.google.com规则虽覆盖了域名，但Document页面的主框架请求可能带有额外查询参数，或规则优先级设置不足，导致拦截未命中。

Google Docs是否存在特殊拦截限制？ #

Google Docs Document确实有网络请求优化机制（如Service Worker缓存、内部重定向、CDN代理），但没有直接阻止declarativeNetRequest拦截的特殊限制，只需调整规则适配其加载流程即可。

可靠的拦截规则写法 #

以下是经过验证的稳定拦截配置：

1. 精确匹配Document路径的主框架规则 #

在rules.json中添加高优先级的路径匹配规则，同时保留域名兜底规则：

[
  {
    "id": 1,
    "priority": 1000,
    "action": {
      "type": "block"
    },
    "condition": {
      "urlFilter": "||docs.google.com/document/",
      "resourceTypes": ["main_frame"]
    }
  },
  {
    "id": 2,
    "priority": 500,
    "action": {
      "type": "block"
    },
    "condition": {
      "urlFilter": "||docs.google.com",
      "resourceTypes": ["main_frame"]
    }
  }
]

2. 覆盖带参数的Document子路径 #

针对https://docs.google.com/document/d/xxx/edit这类带文档ID的URL，使用通配符覆盖所有子路径：

{
  "id": 3,
  "priority": 1000,
  "action": {
    "type": "block"
  },
  "condition": {
    "urlFilter": "||docs.google.com/document/*",
    "resourceTypes": ["main_frame"]
  }
}

3. 拦截Service Worker预加载请求（可选） #

若要彻底阻断所有相关预加载，可添加对service_worker资源类型的拦截：

{
  "id": 4,
  "priority": 1000,
  "action": {
    "type": "block"
  },
  "condition": {
    "urlFilter": "||docs.google.com/document/*",
    "resourceTypes": ["main_frame", "service_worker"]
  }
}

额外注意事项 #

• 确保manifest.json权限声明正确：

  "permissions": ["declarativeNetRequest"],
  "host_permissions": ["*://docs.google.com/*"]
  

• 重新加载扩展时，选择「更新扩展程序」并勾选「刷新页面」，确保规则生效；
• 若仍未生效，可通过Chrome的chrome://net-internals/#events查看Document页面的请求流程，确认规则是否命中。

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