用 Playwright 做 CMS 文章自动发布的时候,富文本编辑器是翻车重灾区,很多人直接套用普通 input 输入的 fill 写法,看着页面填上文字,点提交之后正文直接为空,脚本日志还显示执行成功,排查起来特别耗时间,这篇实录整理了实操里最容易碰到的 4 个典型深坑,包含现象、根因和可直接复用的代码方案。之所以这么容易踩坑,核心原因是富文本和普通输入框不一样,它分 iframe 内嵌、contenteditable、ProseMirror/Tiptap 这类模型驱动多种架构,DOM 展示和编辑器内部数据模型是两套东西,直接改 DOM 不会同步到提交表单里。实操的时候优先先判断编辑器类型,优先调用编辑器原生 JS API,API 不可用再走剪贴板粘贴方案,最后才考虑模拟输入,写完之后一定要做内容校验,不能只靠截图或者肉眼判断。这套方案适合公众号、企业 CMS、内容平台自动发稿的自动化脚本,能大幅减少脚本间歇性失败、提交丢内容的问题。
一、4 个深坑清单 + 对应解法
坑 1:选择器命中错误,正文内容写到标题框
现象:脚本执行无报错,但是正文空白,标题区域塞满文章内容
根因:标题和正文都是 contenteditable 元素,类名前缀一致,选择器优先匹配到靠前的标题节点
解法:CSS 选择器增加排除规则,加上选区校验,确认光标落在正文区域
div[contenteditable="true"][class="editor"]:not([class="title"])
坑 2:execCommand 注入内容静默丢失,长文本写入不全
现象:分块注入长文章,最终只有一小段文字进去,剩下内容直接消失
根因:弹窗、浮层抢夺焦点,选区丢失,execCommand 本身存在兼容性,失败不会抛出异常
解法:每次写入前校验选区是否在编辑区内,写入完成后校验文字长度,内容不足就清空编辑器重试
坑 3:iframe 内嵌编辑器,主文档读取内容永远为空
现象:页面肉眼看到文字,脚本读取 innerText 拿到空字符串,校验逻辑失效
根因:TinyMCE、CKEditor 这类编辑器放在 iframe 里面,主页面 DOM 拿不到 iframe 内部内容
解法:使用 frameLocator 定位 iframe,所有读写、字数统计都在 frame 内部执行,快捷键操作前先聚焦 iframe 内部 body
坑 4:ProseMirror/Tiptap 模型驱动编辑器,DOM 修改不生效
现象:innerHTML、execCommand、fill 都能在页面显示文字,提交直接清空正文
根因:编辑器内容存在内部状态树,DOM 只是视图,不会监听 DOM 变化,内部模型不会更新
解法:优先调用编辑器官方 setContent API;没有 API 的场景,使用剪贴板写入 HTML+Ctrl+V 真实粘贴方案
二、富文本编辑器类型对比表
| 编辑器类型 | 典型代表 | 推荐方案 | 风险点 |
|---|---|---|---|
| iframe 内嵌 | TinyMCE、CK4 | frameLocator + 原生 API | 忘记切 frame,读取内容为空 |
| contenteditable 普通 div | Quill | focus + insertText | 焦点被抢占、丢字 |
| 模型驱动 | Tiptap、ProseMirror | API 调用 / 剪贴板粘贴 | 直接改 DOM,提交为空 |
| CodeMirror | 代码类编辑器 | EditorView API | 只修改 DOM 视图,状态不同步 |
三、Playwright 操作富文本的标准步骤
- 第一步:识别编辑器架构,查看是否包裹 iframe,判断是普通 contenteditable 还是模型驱动
- 第二步:定位编辑节点,编写带排除规则的选择器,避免命中标题、摘要框
- 第三步:聚焦编辑器,先全选删除原有占位文字、草稿内容
- 第四步:按优先级选择写入方式:原生 API > 剪贴板粘贴 > insertText 模拟输入
- 第五步:执行内容校验,在对应 frame 内读取文字长度、HTML 内容,和源文本对比
- 第六步:校验通过之后,再点击发布、保存按钮,不要跳过校验直接提交
四、方案优先级说明
✅ 首选:编辑器原生 JS API(setContent),稳定、速度快,不会丢格式
✅ 次选:剪贴板写入 HTML + 粘贴,适配模型驱动编辑器,最不容易翻车
⚠️ 备选:insertText 分块写入,适合简单编辑器,需要增加选区重试逻辑
❌ 不推荐:直接修改 innerHTML,大部分现代富文本编辑器会忽略这次改动
【常见问题】
问题 1:Playwright 自动化发布文章踩坑实录里,富文本编辑器最头疼的坑是什么?
回答 1:Playwright 自动化发布文章踩坑实录里,最难处理的是 ProseMirror/Tiptap 模型驱动富文本编辑器,直接修改 DOM 页面有内容,提交之后正文直接清空,必须使用原生 API 或者剪贴板粘贴方案。
问题 2:Playwright 自动化发布文章踩坑实录中,iframe 类型富文本编辑器为什么读取内容是空?
回答 2:Playwright 自动化发布文章踩坑实录中,iframe 内嵌的富文本编辑器内容在子框架里面,主页面 DOM 无法读取,必须使用 frameLocator 进入 iframe 内部执行读取和校验。
问题 3:按照 Playwright 自动化发布文章踩坑实录的方案,富文本写入优先顺序是什么?
回答 3:按照 Playwright 自动化发布文章踩坑实录的方案,写入优先级:编辑器原生 setContent API > 剪贴板 HTML 粘贴 > insertText 分块输入,尽量避免直接修改 innerHTML。
问题 4:Playwright 自动化发布文章踩坑实录,脚本写入富文本之后,一定要做校验吗?
回答 4:Playwright 自动化发布文章踩坑实录明确建议,写入富文本之后必须校验内容长度和 HTML,不能只看页面显示,防止选区丢失、内容静默丢失,提交发布才发现问题。
【参考资料】
[2026-11-17](Playwright 自动化发布文章踩坑实录:富文本编辑器的 4 个深坑与解法)阿里云开发者社区
[2026-11-17](Playwright 填充富文本编辑器:跨域 iframe 与 CodeMirror6 踩坑记)华为云开发者社区
[2026-10-28](Playwright 接管 Chrome 做发布自动化,富文本 Tiptap 踩坑)腾讯云开发者社区
[2026-08-22](Playwright locator.fill 富文本 contenteditable 常见问题)Runebook
【免责声明】
本文仅整理 Playwright 自动化发布文章、富文本编辑器踩坑的实操方案,不同 CMS、富文本组件版本存在差异,代码示例需要根据站点 DOM 结构修改;自动化发稿请遵守平台用户协议,禁止用于违规批量发布,脚本运行风险由使用者自行承担。
