Ketcher项目中矩形选择工具自动化测试的重构实践

Ketcher项目中矩形选择工具自动化测试的重构实践

在化学编辑器Ketcher的自动化测试演进过程中，测试执行模式的优化是提升测试可靠性和维护性的重要手段。本文将以rectangle-selection-tool.spec.ts测试文件的重构为例，探讨如何将隔离执行模式迁移到清空画布执行模式。

背景与挑战

化学编辑器作为专业工具，其测试需要模拟复杂的用户交互场景。传统的隔离执行模式虽然能保证测试独立性，但存在两个主要问题：一是测试间状态残留可能导致偶发失败，二是与真实用户操作流程存在差异。清空画布执行模式通过在每个测试用例前重置画布状态，更贴近真实使用场景。

重构方案设计

参考ketcher-2.28.0-bugs.spec.ts的实现，重构需要关注三个核心环节：

1. 画布初始化：在每个测试用例前使用clearCanvas()方法确保初始状态一致
2. 原子操作封装：将常见的绘制操作（如创建化学键、添加原子）抽象为可复用函数
3. 断言优化：基于清空画布后的预期状态设计验证点

具体实现示例

原始隔离测试可能直接操作画布元素：

it('should select atoms within rectangle', () => {
  // 直接在当前画布状态上操作
  selectAtoms(1, 3);
  expect(getSelectedCount()).toEqual(2);
});

重构后的清空画布模式：

beforeEach(() => {
  clearCanvas();
  loadMolecule(defaultStructure);
});

it('should select atoms within rectangle', () => {
  // 在已知初始状态下操作
  const selectionArea = { x1: 10, y1: 10, x2: 50, y2: 50 };
  selectWithRectangle(selectionArea);
  expect(getSelectedAtoms()).toMatchSnapshot();
});

技术收益分析

1. 可靠性提升：消除测试间的隐式依赖，失败用例更容易定位
2. 可维护性增强：测试意图更明确，减少对前置状态的隐式假设
3. 执行效率优化：相比完全隔离的测试环境，清空画布模式减少了初始化开销

最佳实践建议

1. 原子化准备：每个测试应独立完成所需结构的构建
2. 状态验证：在关键操作前后添加画布状态检查点
3. 视觉回归：结合截图比对验证复杂选择场景
4. 性能监控：关注清空大分子画布时的耗时变化

这种重构模式不仅适用于矩形选择工具测试，也可推广到Ketcher的其他交互功能测试中，为化学编辑器提供更健壮的自动化测试保障。