Safari扩展中tabs onUpdated事件未触发问题求助

核心问题分析 #

你的代码在Chromium/Firefox正常，但Safari中标签页仅打开无后续操作，主要是Safari对扩展API的行为细节、权限校验与其他浏览器存在差异，结合你的代码逻辑，以下是具体排查点和修复方案：

1. 权限配置必须精准 #

Safari对主机权限的校验比其他浏览器严格，务必在manifest.json中明确添加Google Scholar的域名权限，同时确保tabs和scripting权限已声明：

"permissions": [
  "tabs",
  "scripting",
  "https://scholar.google.com/*",
  "https://scholar.google.fr/*"
]

注意：通过XCRUN转换后的扩展，需在Xcode项目的Info.plist中确认未限制目标域名的访问（HTTPS域名默认允许，但需覆盖所有可能的跳转域名）。

2. 事件监听逻辑需适配Safari行为 #

原代码存在两个关键逻辑漏洞：

• 未限定监听目标标签页：全局监听所有tabs.onUpdated事件，可能被其他Google Scholar标签页干扰，导致逻辑触发混乱。
• 未检查页面加载完成状态：Safari中tabs.onUpdated会在页面加载的loading、complete等多个阶段触发，原代码仅判断URL，会在页面未完全渲染时执行脚本，导致找不到save按钮，后续回调（移除监听器、关闭标签页）无法执行。

修复方式：在创建标签页的回调中绑定该标签的ID，仅监听此标签的更新，并严格检查changeInfo.status === 'complete'：

// 检测浏览器语言
const gsUrl = currentBrowser.i18n.getUILanguage().includes("fr")
  ? GSCHOLAR_SET_PREFS_FR_URL
  : GSCHOLAR_SET_PREFS_COM_URL;

// 创建标签页后，仅监听该标签的更新
currentBrowser.tabs.create({
  url: `${gsUrl}?inst=${gScholarInstIdList.join("&inst=")}&save=#2`,
  active: false,
}, (createdTab) => {
  const gsTabListener = (tabId, changeInfo, tabInfo) => {
    // 仅处理目标标签页，且页面加载完成
    if (tabId === createdTab.id && changeInfo.status === 'complete' && tabInfo.url.startsWith(GSCHOLAR_HOST)) {
      currentBrowser.tabs.executeScript(
        tabId,
        {
          code: `
            // 先检查按钮是否存在，避免报错中断逻辑
            const saveBtn = document.getElementsByName("save")[0];
            if (saveBtn) saveBtn.click();
          `,
        },
        () => {
          // 无论脚本注入成功与否，都移除监听器并关闭标签页
          currentBrowser.tabs.onUpdated.removeListener(gsTabListener);
          setTimeout(() => {
            // 添加错误捕获，便于排查关闭失败的原因
            currentBrowser.tabs.remove(tabId).catch(err => console.error("关闭标签页失败:", err));
          }, 1500);
        }
      );
    }
  };
  currentBrowser.tabs.onUpdated.addListener(gsTabListener);
});

3. 注入脚本需添加容错处理 #

原注入代码未检查save按钮是否存在，若页面加载异常或DOM结构变化，会抛出错误中断后续逻辑，添加存在性判断可避免此问题。

4. 替代方案：使用webNavigation API（若仍有问题） #

若tabs.onUpdated仍存在兼容性问题，可改用webNavigation.onCompleted，但需确保绑定目标标签ID：

currentBrowser.webNavigation.onCompleted.addListener((details) => {
  if (details.tabId === createdTab.id && details.url.startsWith(GSCHOLAR_HOST)) {
    // 执行脚本、移除监听器、关闭标签页逻辑同上
  }
}, {url: [{hostContains: 'scholar.google'}]});

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