Chrome Extension Manifest V3中如何调试Offscreen Page？

Offscreen Page的日志默认不会在普通扩展控制台显示，你可以通过以下方式调试：

• 直接打开Offscreen Page的独立控制台

  1. 打开Chrome扩展管理页面（地址栏输入chrome://extensions/）
  2. 找到你的扩展，点击「详细信息」
  3. 在「Inspect views」区域，找到对应offscreen.html的入口，点击即可打开专属控制台，这里能查看所有console.log输出

• 通过后台页面转发日志
  若暂时无法直接打开Offscreen控制台，可在Offscreen Page中将日志发送到后台页面，再通过后台控制台查看：
  修改offscreen.js代码：

  chrome.runtime.onMessage.addListener(handleMessages);
  
  console.log('clipboard');
  // 新增：将日志发送到后台
  chrome.runtime.sendMessage({type: "log", message: "clipboard"});
  

  在后台脚本（如background.js）中添加监听：

  chrome.runtime.onMessage.addListener((msg) => {
    if (msg.type === "log") {
      console.log("[Offscreen Log]", msg.message);
    }
  });
  

  之后打开后台页面的控制台就能看到转发的日志

• 额外注意

  • Offscreen Page仅在被激活时运行，要确保你的剪贴板功能触发了它的加载，否则日志不会输出
  • 若用chrome.offscreen.createDocument创建Offscreen Page，需确认创建成功后再查看日志

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