如何用declarativeNetRequest API模拟parentFrameId !== -1的规则匹配？

算力阿峰

2026-8-12

如何用declarativeNetRequest模拟webRequest中parentFrameId !== -1的行为？

核心问题

原webRequest代码通过request.tabId === tabId && request.parentFrameId !== -1，精准匹配指定标签页内iframe发起的所有请求（而非加载iframe本身的请求），实现移除特定响应头的逻辑。但切换到declarativeNetRequest后，找不到对应的规则条件。

现状说明

目前Chrome的declarativeNetRequest API没有直接对应parentFrameId !== -1的规则字段，无法精确复现原逻辑中“仅匹配iframe内部发起的请求”的判断。

你尝试的resourceTypes: [SUB_FRAME]仅匹配加载iframe自身的请求，而非iframe内部发起的资源请求，这确实是该字段的设计逻辑。

近似替代方案

如果可以接受覆盖指定标签页内除主框架之外的所有请求（包括主页面的子资源和iframe内部请求），可以通过排除MAIN_FRAME资源类型来实现近似效果：

const tabId = 42;

await chrome.declarativeNetRequest.updateSessionRules({
  addRules: [
    {
      id: 1,
      action: {
        type: chrome.declarativeNetRequest.RuleActionType.MODIFY_HEADERS,
        responseHeaders: [
          {
            header: 'my-header',
            operation: chrome.declarativeNetRequest.HeaderOperation.REMOVE,
          },
        ],
      },
      condition: {
        tabIds: [tabId],
        // 排除主框架请求，匹配所有其他资源类型
        excludedResourceTypes: [chrome.declarativeNetRequest.ResourceType.MAIN_FRAME],
        urls: ['*://*/*'],
      },
    },
  ],
});