Happy DOM 中脚本注释内特殊字符处理问题解析

2025-06-19 10:22:47作者：江焘钦

Happy DOM 是一个流行的 JavaScript DOM 实现库，用于在 Node.js 环境中重现浏览器 DOM 行为。近期发现该库在处理 <script> 标签内的注释内容时存在特殊字符转义问题，本文将深入分析这一问题的技术细节和解决方案。

问题现象

在 Happy DOM 15.7.4 版本中，当解析包含 JavaScript 注释的 <script> 元素时，注释中的 < 和 > 字符会被错误地转换为 HTML 实体 < 和 >。例如：

<div>
  <script>
    //<>&lt;&gt;
  </script>
</div>

使用 Happy DOM 解析后会得到：

<body><div><script>//&lt;&gt;&lt;&gt;</script></div></body>

而浏览器原生行为（如 Chrome 和 Firefox）会保持原样输出：

<body><div><script>//<>&lt;&gt;</script></div></body>

这个问题源于 XML 序列化器对文本内容的过度转义。在 DOM 解析过程中，Happy DOM 的 XMLSerializer 对所有文本节点内容进行了无差别转义，包括：

这种处理方式虽然对普通 HTML 文本是安全的，但在脚本和样式上下文中会导致语法错误。

在修复过程中，开发团队经历了几个阶段：

正确的实现需要考虑不同上下文环境：

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

DOM 解析和序列化中的字符转义是一个需要精细处理的领域。Happy DOM 通过版本迭代最终实现了与浏览器一致的行为，为开发者提供了更可靠的 DOM 重现环境。理解这类问题的本质有助于开发者在遇到类似场景时更快定位和解决问题。

登录后查看全文