Chrome扩展中如何正确监听Notifications API的onClosed事件？

可能原因及对应解决办法 #

• 后台页面休眠导致事件堆积
  Chrome扩展的非持久化背景页（manifest.json中"background.persistent": false）会在闲置时被挂起，无法实时响应通知关闭事件，直到页面被唤醒才会批量处理累积事件。

  • 临时解决方案：将background.persistent设为true，测试事件是否实时触发。
  • 若需保持非持久化：可通过监听chrome.runtime.onMessage、chrome.notifications.onClicked等能唤醒后台的事件，但无法完全解决通知关闭事件的延迟问题，因为该事件本身不会主动唤醒非持久化后台。

• 监听器注册时机错误
  确保chrome.notifications.onClosed.addListener在后台页面初始化阶段就完成注册，不要放在异步回调（如chrome.runtime.onMessage回调）中，避免错过早期的通知关闭事件。

• 权限配置遗漏
  确认manifest.json已正确声明notifications权限：

  {
    "permissions": ["notifications"]
  }
  

• 通知创建配置干扰
  检查通知创建代码，避免不必要的配置影响事件传递，示例创建代码：

  chrome.notifications.create({
    type: "basic",
    iconUrl: "icon.png",
    title: "测试通知",
    message: "这是一条测试通知",
    requireInteraction: false
  });
  

• Chrome版本或环境问题
  更新Chrome至最新稳定版，或在无痕模式下测试，排除其他扩展干扰。

临时Workaround #

若上述方法无法解决，可在通知点击/按钮点击时主动触发关闭逻辑（覆盖部分场景），示例：

chrome.notifications.onClicked.addListener((notifId) => {
  chrome.notifications.clear(notifId, () => {
    // 执行自定义关闭逻辑
    console.log("通知被点击后关闭");
  });
});

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