Chrome扩展ExtensionSidebarPane自定义HTML页面的数据传递方案
问题根源
你的判断方向是对的,异常完全来自Chrome扩展不同运行上下文的域隔离规则,具体隔离边界是:
- 最初存储数据的执行环境:是通过
chrome.devtools.inspectedWindow.eval运行的代码,它的运行域是当前被调试的网页域,存入localStorage的savedDataForReview值,归属被调试网站的本地存储空间 - 后续替换成
pane.setPage()加载的my_reviewing_pane.html:这个资源属于扩展自身的chrome-extension://协议域,它内部脚本访问的localStorage完全归属扩展自己的存储空间,和被调试网站的存储域完全隔离,自然取不到之前存在网页域下的目标值 - 早期
setObject流程能正常运行,是因为当时读取数据的动作完全发生在被调试网页的执行上下文里,根本没有走扩展页面的存储通道,逻辑是自洽的。
兼容现有setPage能力的实现方案
不需要调整setPage的入参形式,按以下步骤走就能打通数据传递链路:
- 在创建侧边栏的devtools主脚本(即对应devtools.html的配套JS)里,保留原有
chrome.devtools.inspectedWindow.eval的读取逻辑,把从被调试网页域拿到的目标数据暂存在脚本作用域中- 示例代码:
let parsedReviewData = null; // 读取被调试网页的localStorage目标值 chrome.devtools.inspectedWindow.eval( "localStorage.getItem('savedDataForReview')", (res, err) => { if (err || !res) return; parsedReviewData = JSON.parse(res); } ) - 监听侧边栏页面的加载完成事件,利用同扩展域下的通信能力把暂存的数据传递给侧边栏加载的本地HTML
- 示例代码:
const reviewPane = chrome.devtools.panels.elements.createSidebarPane("Data Reviewing Panel"); reviewPane.setPage("html/my_reviewing_pane.html"); // 侧边栏页面渲染完成后同步数据 reviewPane.onShown.addListener((paneWindow) => { paneWindow.addEventListener("load", () => { paneWindow.postMessage({ action: "LOAD_REVIEW_DATA", data: parsedReviewData }, "*") }) }) - 在侧边栏HTML的内嵌脚本里接收通信传来的数据,后续所有表格渲染、按钮交互逻辑都基于这份接收的数据实现,不需要再主动调用
localStorage读取- 示例代码:
// my_reviewing_pane.html内嵌JS window.addEventListener("message", (e) => { if (e.data.action !== "LOAD_REVIEW_DATA") return; const reviewData = e.data.data; // 在此处实现表格渲染、按钮事件绑定等复杂交互 })
注意事项
- 无需尝试绕过
setPage的入参限制,同扩展域下的postMessage通信完全能满足复杂交互界面的需求 - 如果被调试网页端的目标存储值后续有动态更新,可以在
chrome.devtools.inspectedWindow.eval的执行上下文里注册storage事件监听,检测到savedDataForReview变化时,重新把最新值通过postMessage同步给侧边栏页面,保证数据一致性 - 不要在侧边栏页面的脚本里尝试读取自身域的
localStorage拿目标数据,两个存储域没有互通通道,这类读取操作永远会返回null
内容的提问来源于stack exchange,提问作者Alex Bowyer
相关产品推荐
相关产品推荐

