第六部分 — 网络、安全和规则 webRequest（剩余功能，替代方案）

14.1 目的

在 MV3 中，webRequest 对大多数“修改流量”用例进行了限制。 通常会迁移到 DNR。 Important nuance:

• 在许多情况下，仍然可以观察请求。

• 通过webRequestBlocking进行阻塞/修改通常在典型的MV3 Chrome Web Store扩展中不可用；请计划使用DNR替代方案（企业级或策略安装的场景可能有所不同）。

此部分解释了哪些功能仍然可用以及您的替代方案。

14.2 使用时机 / 避免使用时机

使用时机： 当您需要在允许的情况下进行观察（请求元数据）时。

避免使用时机： 当您想要阻塞/重定向/修改请求（请使用DNR）时。

14.3 替代方案映射

• 需要阻塞/重定向/头编辑 → DNR

• 需要在页面级别进行观察 → 使用内容脚本 + fetch/XHR挂钩

• 需要代理般的行为 → 重新考虑架构（服务器端）

最小示例

非阻塞请求观察（MV3安全）:

权限：

• webRequest

• 您希望观察的URL的主机访问

chrome.webRequest.onBeforeRequest.addListener( (details) => { // Observation only (no blocking/modifying in typical MV3 CWS extensions). console.log("request:", details.method, details.url); }, { urls: ["*://example.com/*"] } );

14.4 常见问题

• 围绕 MV2 假设设计新的 MV3 功能。

• 发布范围过宽的权限，导致审核失败。

• 使用 <all_urls> “以防万一”（需审核 + 信任风险）。

• 对于子资源请求，通常需要对所请求 URL 及其发起者都有主机访问权。

14.5 检查清单

• [ ] 优先使用 DNR 进行请求控制

• [ ] 保持权限最小化

• [ ] 提供清晰的审核理由

14.6 参考资料

• webRequest: webRequest

• DNR: https://developer.chrome.com/docs/extensions/reference/api/declarativeNetRequest

• MV3 迁移概述: https://developer.chrome.com/docs/extensions/develop/migrate