嘿，刚好我对Chrome扩展的网络拦截功能挺熟的，给你梳理下核心的API和相关要点：

1. chrome.declarativeNetRequest API #

这是Chrome官方现在主推的方案，优势是性能高（规则由浏览器底层处理，不占用扩展进程资源），而且不需要申请过于宽泛的权限。它能实现的核心功能包括：

• 拦截、允许或阻止特定网络请求
• 修改请求头/响应头
• 重定向请求到指定URL
• 修改响应体（需要配合declarativeNetRequestWithHostAccess权限，且规则配置相对复杂）

使用它需要在扩展的manifest.json中声明对应的权限，比如：

{
  "permissions": ["declarativeNetRequest", "*://*.example.com/*"]
}

你可以通过添加规则的方式实现拦截修改，比如给所有请求添加自定义响应头：

chrome.declarativeNetRequest.updateDynamicRules({
  addRules: [{
    id: 1,
    priority: 1,
    action: {
      type: "modifyHeaders",
      responseHeaders: [{
        operation: "append",
        header: "X-Custom-Header",
        value: "MyChromeExtension"
      }]
    },
    condition: {
      urlFilter: "*",
      resourceTypes: ["main_frame", "sub_frame"]
    }
  }]
});

2. chrome.webRequest API #

这个是更传统的方案，灵活性更高，适合需要动态逻辑处理的场景（比如根据请求内容实时决策修改方式），但性能比declarativeNetRequest稍差，因为需要在扩展进程中处理事件。它的核心能力包括：

• 在请求生命周期的各个阶段（发送前、接收头后等）插入自定义逻辑
• 修改请求头/响应头
• 拦截并修改响应体（需要用chrome.webRequest.filterResponseData创建数据流处理器）

使用它需要声明webRequest和webRequestBlocking权限，比如：

{
  "permissions": ["webRequest", "webRequestBlocking", "*://*.example.com/*"]
}

举个修改请求头的例子：

chrome.webRequest.onBeforeSendHeaders.addListener(
  (details) => {
    details.requestHeaders.push({name: "X-Custom-Header", value: "MyChromeExtension"});
    return {requestHeaders: details.requestHeaders};
  },
  {urls: ["*://*.example.com/*"]},
  ["blocking", "requestHeaders"]
);

你直接去Chrome官方的扩展开发文档里搜这两个API的名称就能找到完整的参数说明、权限要求和示例代码。比如搜“chrome.declarativeNetRequest”或者“chrome.webRequest”，就能看到官方的详细指导，包括规则写法、事件触发时机、权限的具体限制等。

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