夜雨聆风学习资料网

ARTICLE · 1364531

排版插件开发手记5:算对了却送不进去,四级链路与隔离世界,隔离世界、四级写入口、落地判定

排版插件开发手记5:算对了却送不进去,四级链路与隔离世界,隔离世界、四级写入口、落地判定
样式算对了,按接口送进去,应该一步到位吧?我栽在最反直觉的一件事上——你在插件里看到的页面,和页面自己看到的,不是同一个。

一 · 隔离世界:你读不到页面的接口

第 4 篇把样式算对了。按理说,拿着算好的 HTML 调编辑器的写入接口,一步到位。

我第一版就是这么想的,也这么写的。结果:每台机器都稳定亮黄——自检报告里那一项,永远判定「编辑器未识别」。

我在内容脚本里读页面 window 上的接口,读出来是 undefined。

根因是「隔离世界」(isolated world)。Chrome 的内容脚本运行在一个独立的 JavaScript 世界里,它看不到页面自己那个世界里的全局变量。所以 window.__editorBridge__ 在内容脚本眼里恒为空——不是没装,是它压根看不见。

任何「页面有没有挂某个全局」的判据,只要写在内容脚本里,就是恒定假。比假红更糟的是假黄:它不报错,但每次都误导你。

二 · 解法:站到主世界去读,但只读 typeof

修法是把探测挪到主世界:经 chrome.scripting.executeScript({ world: 'MAIN' }) 执行一段函数,让它站到页面的世界里去读。

但「站到主世界」不等于「可以为所欲为」。我给自己三条硬约定:

  1. 只读不 invoke。
     探测函数只判断 typeof,绝不调用页面的任何函数。调用会污染用户的草稿,也会引入不可控行为。
  2. 函数自包含。
     这段探测代码不依赖任何外部变量,单独能跑。
  3. 超时降级。
     8 秒内读不到就降级处理,不卡死导入。

这么做,自检面板才能「随时可点、不污染草稿」——这是第 2 篇第三条规矩「出问题能说清」的前置条件。

三 · 四级写入口:一条主路,三条退路

读到了接口,怎么写进去?我设计了四级链路,主路优先,逐级降级:

  • L0 编辑器接口。
     优先调 invoke('mp_editor_insert_html')——这是编辑器正规写入通道,最干净。
  • L1 DOM 覆盖。
     接口不可用,直接操作编辑区 DOM,把算好样式的子树挂上去。
  • L2 execCommand。
     调 document.execCommand('insertHTML', ...)。
  • L3 剪贴板。
     最后兜底,把 HTML 写进剪贴板,提示用户 Ctrl+V。

为什么 L2 不能当主路径?因为 execCommand('insertHTML') 会剥掉 h1–h6 的 font-weight(700 / bold / 800 都剥),p 不剥。两层重解析之后,标题的字重全没了。加粗只能靠标签语义兜底。所以 L2 是退路,不是主路。

四 · 插入前规整与落地判定

写入口确定后,还要处理两件事。

插入前规整(四步):给叶子节点套 span[leaf] 标;清掉 colgroup(表格列宽容器,进了编辑器反而坏排版);吃掉多余空白;图片先占位,避免一次性拽入大图阻塞。

落地判定:插入前记录正文长度,插入后比对。增量 ≥ 50% 且 ≥ 10 字符,才判「成功」。这条判定救过我:有次接口其实没生效,但「返回成功」了,靠落地判定当场抓出来——这正是第 1 篇说的「返回成功但排版错且不说为什么」的反面:我们要的是「成功」真的发生了。

五 · 衔接:功能在跑,没人知道跑什么

这一篇,把第 1 篇的「坑二」拆完了:隔离世界的假黄、四级链路、落地判定。功能从「算对」走到「能送进去」。

但第 1 篇的「坑三」还在:功能在跑,可你不知道它到底跑了什么、哪一步出了问题。用户只会说一句「不对」,然后呢?

下一篇,讲我怎么让每一次导入「可解释」。

最后

送不进去,往往不是接口难调,而是你站错了世界。隔离世界是 Chrome 的安全设计,但它是「安静地挡住你」——你在内容脚本里读到的,永远是 undefined。

站到主世界去读、只 typeof 不调用、四级降级、落地判定。这一套下来,「算对了送进去」才真正成立。

下一篇,从那句最让人头疼的「不对」说起。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料