Chrome扩展：allFrames与frameIds注入JS在亚马逊站点的差异问题

问题背景 #

开发的Chrome扩展在弹窗打开时注入JS代码抓取当前活动标签页图片，在amazon.DE产品页出现注入环节中断、后续代码无法执行且无报错的问题，但amazon.COM上正常。推测原因是代码注入到了与主标签页主机不一致的frame中。

配置与代码 #

manifest.json配置 #

{    
    "manifest_version": 3,
    "permissions": [
      "storage",
      "unlimitedStorage",
      "activeTab",
      "scripting",
      "webNavigation"
    ]
}

注入代码片段 #

async scrape() {
    let tabs = await chrome.tabs.query({ currentWindow: true, active: true });
    let tab = tabs[0];

    let frames = await chrome.scripting.executeScript({
      target:{tabId: tab.id, allFrames: true},
      func:grabImages
    });
}

测试结果 #

• 脚本总能注入到主frame并正常执行预期操作
• 使用allFrames: true注入到amazon.COM时无问题
• 使用frameIds: [所有frame的ID列表]注入时，报错：Uncaught (in promise) Error: Cannot access contents of the page. Extension manifest must request permission to access the respective host.
• 使用allFrames:true注入到amazon.DE时静默失败
• 代码在amazon.DE首页正常工作，仅产品页失效
• 在amazon.DE产品页完全加载前快速点击扩展，可部分工作（缺少部分图片）
• amazon.COM产品页有3个frame，amazon.DE产品页有7个frame

疑问解答 #

1. allFrames: true与frameIds: []注入JS的差异 #

• allFrames: true会尝试向标签页内所有frame注入脚本，但会自动跳过没有权限访问的frame，不会抛出错误，仅忽略这些frame的注入请求，整个Promise仍会正常resolve，返回成功注入的frame结果。
• frameIds: [xxx]是显式指定要注入的frame列表，Chrome会严格尝试向每个指定的frame注入。如果其中某个frame的主机不在扩展权限范围内，会直接抛出权限错误，导致整个executeScript的Promise被拒绝，后续代码因此无法执行。

2. 为何allFrames: true在amazon.COM正常，在amazon.DE静默失败？ #

核心原因是amazon.DE产品页的跨域frame数量更多、加载逻辑更复杂：

• amazon.DE产品页的7个frame中存在多个第三方域名（非amazon.de）的frame，这些frame不在activeTab权限覆盖范围内（activeTab仅授予当前活动标签页主域名的权限）。
• 当allFrames: true注入时，虽然Chrome会跳过无权限的frame，但amazon.DE产品页中部分跨域frame的加载状态异常（比如持续处于加载中），导致executeScript的Promise迟迟无法resolve，表现为“静默失败”——主frame的脚本其实已执行，但后续代码因Promise未完成而无法运行。
• 另外，amazon.DE产品页完全加载后，部分跨域frame的权限限制会更严格；而加载前快速点击扩展时，这些跨域frame还未完全初始化，注入流程未被阻塞，因此能部分生效。

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