CKEditor 4 Edge 焦点回归测试解析:修复失焦后双击才能选中 Widget 的缺陷(1458)

原创2026-10-15 15:11:561,904 阅读
文章标签:前端UI组件

CKEditor 4 Edge 焦点回归测试解析:修复失焦后双击才能选中 Widget 的缺陷(#1458)

导读

本文围绕 CKEditor 4 仓库中的 Bender 手动测试用例 edgefocus.md 展开,剖析其在 Microsoft Edge 浏览器下验证的一个焦点相关缺陷:编辑器失焦后再点击图片 Widget,需要点击两次才能选中它。读完本文,你将理解该手动测试的复现步骤、断言方式、Edge 专属测试守卫的写法,以及缺陷在源码层面的成因与修复记录,并掌握同一类焦点回归测试(focus、divareafocus、nestededitablefocus)的组织方式。

一、测试用例的背景:Copy Formatting 插件的 Bender 手动测试

在 CKEditor 4 仓库中,tests/plugins/copyformatting/manual/ 目录集中存放了针对 copyformatting 插件 的手动测试用例。这类用例由 Bender 测试框架驱动,以 *.md(测试说明)加 *.html(测试页面)成对出现:

  • *.md 文件通过 @bender-tags、@bender-ui、@bender-ckeditor-plugins 等指令声明测试的元信息、UI 形态与需要加载的插件;
  • *.html 文件提供真实的可运行页面,并在必要时加入环境判断脚本(例如仅当运行在 Edge 时才执行测试)。

edgefocus.md 属于这批手动测试中针对浏览器特定缺陷(bug)的回归用例。它关注的并不是 Copy Formatting 的复制/粘贴格式功能本身,而是与该插件同在一个经典编辑器实例中的 image2 Widget 的聚焦行为,因此其插件清单中同时出现了 copyformatting 与 image2。

二、edgefocus 测试场景逐条解析

edgefocus.md 的完整测试场景如下:

@bender-tags: bug, 4.10.0, copyformatting, 1458
@bender-ui: collapsed
@bender-ckeditor-plugins: copyformatting,toolbar,wysiwygarea,image2

## Test Scenario

1. Make sure the editor is not focused.
2. Select the image on the left by clicking on it.
3. Remove selection from the image by clicking outside the editor.
4. Again click on the image on the left.

## Expected

Image is selected.

## Unexpected

Image is not selected.

1. 元信息声明

指令 值 含义
@bender-tags bug, 4.10.0, copyformatting, 1458 该用例是缺陷回归测试,关联版本 4.10.0,涉及 copyformatting 插件与 issue 编号 1458
@bender-ui collapsed 测试页面以折叠(compact)形态展示
@bender-ckeditor-plugins copyformatting,toolbar,wysiwygarea,image2 页面加载 copyformatting、toolbar、wysiwygarea、image2 四个插件

其中 1458 对应 CHANGES.md 中 4.10.0 版本的一条修复记录:

Fixed: [Edge] Fixed: After blurring the editor it takes 2 clicks to focus a widget.

即:在 Edge 浏览器中,编辑器失焦后需要点击两次才能聚焦(选中)Widget,本用例正是这一修复的回归验证。

2. 操作步骤与断言逻辑

步骤设计为一个"失焦 → 聚焦 → 再失焦 → 再聚焦"的循环,刻意制造出最容易触发缺陷的状态序列:

  1. Make sure the editor is not focused —— 确保编辑器当前未获得焦点,这是触发缺陷的前提状态;
  2. Select the image on the left by clicking on it —— 第一次点击左侧图片(image2 插件渲染的 Widget),使其被选中;
  3. Remove selection from the image by clicking outside the editor —— 点击编辑器外部区域,将选区清除、让编辑器失焦(blur);
  4. Again click on the image on the left —— 第二次点击同一张图片。

Expected(预期):图片被选中 —— 即点击一次就应立即选中 Widget; Unexpected(意外):图片未被选中 —— 即第一次点击被"吞掉",必须再点一次才能选中,也就是缺陷复现。

从修复记录可以推断,缺陷的根因在于 Edge 对"编辑器失焦后重新聚焦"的事件时序处理与其他浏览器不一致:失焦后第一次点击可能只完成了编辑器/文档的重新聚焦动作,而未把点击传递到 Widget 的选中逻辑,导致表现为"需要 2 次点击"。

三、测试页面实现与 Edge 专属守卫

与 edgefocus.md 配套的 edgefocus.html 提供了可运行的测试载体:

<textarea name="editor1" id="editor1" cols="30" rows="10">
	<p><img alt="cake" src="http://c.cksource.com/a/1/img/demo/brownie.jpg" style="height:133px; width:200px" /></p>
</textarea>

<script>
	if ( !CKEDITOR.env.edge ) {
		bender.ignore();
	}

	CKEDITOR.replace( 'editor1' );
</script>

页面本身非常精简:一个 textarea 作为编辑器的替换目标,内容仅含一张居左的 img;脚本通过 CKEDITOR.replace( 'editor1' ) 创建经典(iframe 型)编辑器实例。

关键在于开头的环境守卫:

if ( !CKEDITOR.env.edge ) {
	bender.ignore();
}

bender.ignore() 是 Bender 测试框架提供的"跳过当前用例"接口。由于该缺陷只在 Microsoft Edge 下出现,因此在非 Edge 浏览器中直接忽略本用例,避免在其他环境中产生无意义的失败。这种写法在 tests/plugins/copyformatting/manual/iebackground.html 中也有镜像用法(if ( !CKEDITOR.env.ie || CKEDITOR.env.edge ) { bender.ignore(); }),可见"按浏览器环境条件跳过测试"是 CKEditor 4 浏览器回归测试的标准手法。

CKEDITOR.env.edge 标志定义于 core/env.js:运行时通过解析 navigator.userAgent 中的 edge \/ 片段得到,且 env.ie 在 Edge 下同样为 true(源码注释明确说明:This property is also set to true if CKEditor is running in Microsoft Edge)。也就是说,在源码层面 Edge 长期被视为 IE 家族成员,同时又通过独立的 env.edge 标志区分对待。

四、源码层面的佐证:Edge 在焦点与命令执行上的特殊处理

缺陷 #1458 的修复记录在 CHANGES.md 4.10.0 版本段;而从当前源码中也能找到与 Edge 焦点行为直接相关的分支逻辑。

以 Copy Formatting 插件的 applyFormatting 命令定义为例,plugins/copyformatting/plugin.js 中有:

applyFormatting: {
	editorFocus: CKEDITOR.env.ie && !CKEDITOR.env.edge ? false : true,
	exec: function( editor, data ) { ... }
}

该行清晰地展示了 Edge 被单独对待的事实:命令的 editorFocus 标志在"IE 且非 Edge"时为 false,而在包括 Edge 在内的其他浏览器中为 true——也就是说,执行 applyFormatting 命令时是否需要先聚焦编辑器,Edge 与 IE 走的是不同策略。可以推断,这正是因为 Edge 在"编辑器失焦后重新执行命令/选中 Widget"时的行为与旧版 IE 不同,需要区别处理。

同类证据还有 plugins/copyformatting/plugin.js 中的 contentDom 监听:经典编辑器以整个 editor.document 作为 mouseup 宿主(而非仅可编辑区),注释说明"否则点击 body 边距不会触发事件",这解释了 edgefocus.html 测试中"点击编辑器外部再点击图片"这一交互链路背后的事件绑定机制。

另外,tests/plugins/copyformatting/manual/edgefocus.md 标注的 4.10.0 版本号与 CHANGES.md 中 ## CKEditor 4.10 版本段完全对应,可以从仓库版本历史中确认该用例是随 4.10.0 修复一起引入的回归测试。

五、同一批次的焦点回归测试:聚焦行为测试族

edgefocus 并非孤立的用例。在 tests/plugins/copyformatting/manual/ 目录下,还存放着一组主题相近的焦点(focus)回归测试,共同覆盖"编辑器/Widget 焦点切换"的各种边界场景:

用例 标签 验证内容
focus.md bug, 4.7.0, 4.10.0, trac16845, copyformatting, 1458 编辑器失焦并滚动后点击右侧图片,不应滚动回顶部,图片应被选中;同样关联 issue 1458
edgefocus.md bug, 4.10.0, copyformatting, 1458 本文主角:Edge 下失焦后点击图片应一次选中
divareafocus.md bug, copyformatting, 4.6.0 启用 divarea 插件时,点击第一个编辑器不应把焦点错误地交给第二个编辑器
nestededitablefocus.md bug, 4.11.3, 2655, 2470 点击 Widget 嵌套可编辑区后,焦点应保持在其中,而不是瞬间进入又消失

其中 focus.md 与 edgefocus.md 共享 1458 标签,验证的是同一缺陷在"滚动定位"这一变体下的表现(Unexpected 为 The editor scrolls to the top)。这类成组的用例设计思路是:一个缺陷修复后,用多个手工场景覆盖不同触发路径,确保回归验证充分。

六、如何运行这些手动测试

CKEditor 4 的手动测试通过 Bender 框架运行。仓库根目录提供 bender.js、bender.ci.js 与 bender-runner.config.json 配置文件,运行方式为:

# 安装依赖后启动 Bender 测试服务器
bender server run

# 在浏览器中打开 Bender 页面,导航到
# tests/plugins/copyformatting/manual/edgefocus

运行前提说明:

  • 由于 edgefocus.html 中有 if ( !CKEDITOR.env.edge ) { bender.ignore(); },本用例只在 Microsoft Edge(旧版 EdgeHTML 内核)下才会实际执行,其他浏览器会被自动跳过;
  • 测试页面中的图片资源(如 c.cksource.com 上的示例图)为远程外链,离线环境下图片可能无法加载,但焦点交互逻辑不受影响;
  • 手动测试需要人工按 *.md 中的步骤操作并判断 Expected/Unexpected,因此适合在目标浏览器中逐项核对。

七、关联功能补充:Copy Formatting 插件配置速览

虽然 edgefocus 用例本身只验证焦点行为,但它所属的 copyformatting 插件是 CKEditor 4 的格式复制粘贴功能。若要在实际项目中复现该测试场景或理解插件行为,可在 config.js 或编辑器实例配置中调整以下参数(定义于 plugins/copyformatting/plugin.js):

配置项 默认值 说明
copyFormatting_allowRules 'b s u i em strong span p div td th ol ul li(*)[*]{*}' 允许从哪些元素提取样式(ACF 语法),设为 true 可关闭过滤
copyFormatting_disallowRules '*data-cke-widget*,data-widget*,data-cke-realelement' 明确禁止提取样式的元素(默认排除 Widget)
copyFormatting_allowedContexts true 允许的上下文,可选 'text'、'list'、'table' 或其数组
copyFormatting_keystrokeCopy CKEDITOR.CTRL + CKEDITOR.SHIFT + 67(Ctrl+Shift+C) 复制格式快捷键,设为 false 可禁用
copyFormatting_keystrokePaste CKEDITOR.CTRL + CKEDITOR.SHIFT + 86(Ctrl+Shift+V) 粘贴格式快捷键,设为 false 可禁用
copyFormatting_outerCursor true 激活复制格式时是否为整页附加"禁用"光标样式

需要说明的是,这些配置项与 edgefocus 用例无直接因果关系,此处仅作背景补充;该用例的真正价值在于:它验证了 Copy Formatting 工具栏按钮、Widget(image2)与经典编辑器焦点机制在同一页面上共存时的交互正确性。

八、小结

edgefocus.md 是一份典型的浏览器缺陷回归手动测试,其要点可以总结为:

  1. 精准复现:通过"聚焦 → 失焦 → 再聚焦"的步骤序列,在 Edge 下稳定复现"需要两次点击才能选中 Widget"的缺陷;
  2. 明确断言:用 Expected(图片被选中)/ Unexpected(图片未被选中)二元结构定义通过标准;
  3. 环境隔离:借助 CKEDITOR.env.edge + bender.ignore() 将用例限定在 Edge 浏览器中执行,避免污染其他环境的测试结果;
  4. 版本挂钩:通过 @bender-tags 中的 4.10.0 与 1458,与 CHANGES.md 的修复记录一一对应,形成"缺陷 → 修复 → 回归测试"的完整闭环。

对 CKEditor 4 的贡献者而言,tests/plugins/copyformatting/manual/ 目录(连同其中的 focus.md、divareafocus.md、nestededitablefocus.md 等用例)是学习"如何为浏览器特定缺陷编写手动回归测试"的最佳范本;而对插件开发者来说,它同时也演示了经典编辑器、Widget 与焦点管理器三者交互时最容易踩坑的场景。

登录后查看全文
ckeditor4