Happy DOM 中 details 元素与 JSDOM 的行为差异分析

Happy DOM 作为一款轻量级的 DOM 实现库，在大多数场景下能够很好地模拟浏览器行为。然而，近期发现其在处理 HTML5 的 details 元素时存在与标准浏览器及 JSDOM 不一致的行为，这可能会影响前端测试的准确性。

问题核心

details 元素是 HTML5 引入的一个交互式控件，用于创建可展开/折叠的内容区域。其核心特性是通过 open 属性控制显示状态：

1. 当 open 属性存在时（无论值为何），details 内容区域展开
2. 当 open 属性不存在时，details 内容区域折叠

测试发现，Happy DOM 在处理 details 元素的 open 属性时存在以下差异：

• 在 JSDOM 和浏览器中，当 details 关闭时，元素上不会保留 open 属性
• 在 Happy DOM 中，即使 details 关闭，元素上仍会保留 open="false" 的属性

技术影响

这种差异会导致基于属性选择器的 CSS 样式、属性检查的测试用例以及依赖 DOM 属性状态判断的逻辑出现不一致。例如：

/* 以下选择器在 Happy DOM 中可能无法按预期工作 */
details:not([open]) {
  display: none;
}

在测试场景中，类似这样的断言可能会失败：

expect(element).not.toHaveAttribute('open');  // 在 Happy DOM 中失败

解决方案

Happy DOM 项目维护者已经意识到这一问题，并在最新版本中进行了修复。修复的核心思路是：

1. 完全遵循 HTML 标准对 details 元素的规范
2. 确保 open 属性的存在与否真实反映元素的展开状态
3. 移除 open="false" 这种非标准的属性表示方式

开发者建议

对于使用 Happy DOM 的开发者，建议：

1. 检查测试用例中所有涉及 details 元素的断言
2. 避免依赖 open 属性的具体值，而是检查属性是否存在
3. 升级到修复后的 Happy DOM 版本以确保一致性

总结

DOM 实现库的行为一致性对于前端测试至关重要。Happy DOM 对 details 元素的修复体现了其对标准兼容性的持续改进。开发者应当关注这类底层差异，确保测试环境与真实浏览器环境的一致性，从而构建更可靠的测试套件。