如何解决浏览器扩展beforeunload中sendMessage的上下文卸载Promise拒绝错误

1. 规避错误的合理实现方案 #

该错误的本质是beforeunload触发时，弹窗上下文已经进入销毁流程，异步消息还没完成回调上下文就被销毁，属于浏览器扩展框架的系统级错误，常规异步捕获逻辑无效，推荐从业务逻辑侧调整规避：

• 最优方案：状态变更实时同步
  不要等到关闭时才一次性发送状态，而是在弹窗尺寸、位置发生变化时就同步到后台，从根源上避免关闭阶段的通信操作。添加防抖处理避免高频触发通信，参考代码如下：

// 防抖300ms，避免拖动/缩放过程中高频发消息
const debounce = (fn, delay = 300) => {
  let timer = null;
  return (...args) => {
    clearTimeout(timer);
    timer = setTimeout(() => fn.apply(this, args), delay);
  }
}

const syncState = debounce(() => {
  browser.runtime.sendMessage({
    action: 'save_state',
    data: {
      width: window.outerWidth,
      height: window.outerHeight,
      top: window.screenTop,
      left: window.screenLeft
    }
  }).catch(() => {});
})

// 绑定尺寸、位置变更事件
window.addEventListener('resize', syncState);
window.addEventListener('move', syncState);
// 弹窗初始化先同步一次初始状态
syncState();

该方案完全规避了关闭阶段的通信，不仅不会抛出错误，保存成功率也比关闭时一次性同步高很多。

• 替代方案：通过长连接断开事件触发保存
  弹窗初始化时和后台建立runtime.Port长连接，每次状态变更时把最新参数同步给后台暂存，弹窗关闭时会自动触发后台的onDisconnect事件，直接在后台执行保存即可，不需要弹窗在关闭阶段主动发消息：
  弹窗侧代码：

const port = browser.runtime.connect({name: 'popup_state_port'});
const updateState = () => {
  port.postMessage({
    state: {
      width: window.outerWidth,
      height: window.outerHeight,
      top: window.screenTop,
      left: window.screenLeft
    }
  });
}
window.addEventListener('resize', updateState);
window.addEventListener('move', updateState);
updateState();

后台侧代码：

let latestPopupState = {};
browser.runtime.onConnect.addListener(port => {
  if (port.name !== 'popup_state_port') return;
  // 接收弹窗同步的最新状态暂存
  port.onMessage.addListener(msg => {
    latestPopupState = msg.state;
  });
  // 弹窗关闭自动触发断开事件，直接保存状态
  port.onDisconnect.addListener(() => {
    browser.storage.local.set({popupState: latestPopupState});
  });
});

2. 错误屏蔽方法 #

如果不想调整现有逻辑，目前没有代码层面可以直接拦截该错误的方案：这个错误是浏览器扩展内核抛出的系统日志，不属于页面JS上下文的未捕获异常，所以catch、try/catch、window.onunhandledrejection都无法拦截。
可行的处理方式是在开发者工具的控制台过滤规则中，添加Promise rejected after context unloaded作为排除关键词，排查日志时就不会显示这条干扰信息。

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