Phoenix LiveView 中 page_title/1 测试方法的 HTML 转义问题解析

在 Phoenix LiveView 测试中，page_title/1 方法的行为存在一个值得注意的特性：当通过 patch 导航到页面时，该方法返回的标题不需要 HTML 转义，而通过重定向或初始加载页面时则需要。这一差异可能会给开发者编写测试用例带来困惑。

问题本质

这个问题的根源在于 LiveView 测试客户端获取页面标题的两种不同方式：

1. 初始加载或重定向情况：测试客户端从渲染的 HTML 中提取标题，此时标题已经被 HTML 转义
2. patch 导航情况：测试客户端直接从 LiveView 的 diff 中获取原始标题值，未经转义

技术细节分析

在 Phoenix LiveView 的测试客户端实现中，这两种情况分别由不同的代码路径处理：

• 对于 HTML 渲染的情况，测试客户端使用 Floki 解析 HTML 文档获取标题，此时特殊字符如单引号会被转义为 HTML 实体
• 对于 patch 操作，测试客户端直接从 LiveView 的实时更新中获取标题数据，保留了原始字符串形式

解决方案探讨

从技术实现角度看，有两种可能的解决方案：

1. 统一转义：对所有来源的标题都进行 HTML 转义处理，保持一致性
2. 统一不转义：对 HTML 解析获取的标题进行反转义处理

第一种方案实现更简单，因为 Phoenix.HTML 已经提供了转义函数，而反转义则需要额外处理。但无论采用哪种方案，关键是要保持行为的一致性，避免给开发者带来困惑。

实际影响

这个问题主要影响包含特殊字符的页面标题测试，例如包含单引号、双引号、& 符号等需要 HTML 转义的字符。开发者在编写测试时需要注意：

• 如果测试涉及初始加载或重定向，断言中需要使用转义后的字符串
• 如果测试仅涉及 patch 导航，则可以直接使用原始字符串

最佳实践建议

为避免混淆，建议开发者在测试页面标题时：

1. 明确测试场景的导航方式
2. 对于包含特殊字符的标题，统一使用 Phoenix.HTML.html_escape/1 处理预期值
3. 考虑在测试辅助函数中封装标题断言逻辑，隐藏实现细节

这种不一致性虽然可能被视为框架的一个小缺陷，但了解其原理后，开发者可以更有信心地编写可靠的测试用例。