Playwright-Python 中捕获浏览器错误日志的正确方法

事件监听器的执行时机问题

在使用Playwright-Python进行自动化测试时，开发者经常需要捕获浏览器控制台的错误日志和未捕获的JavaScript异常。一个常见的误区是在页面加载完成后才设置事件监听器，这会导致错过页面加载过程中产生的错误。

问题现象分析

当开发者尝试在页面加载后设置page.on("pageerror")和page.on("console")监听器时，会出现以下情况：

1. 页面加载过程中产生的错误无法被捕获
2. 监听器打印的错误信息出现在断言之后
3. 错误收集列表始终为空

这是因为事件监听器的设置时机太晚，错过了页面初始化阶段可能发生的错误。

正确的实现方式

正确的做法是在导航到目标页面之前就设置好所有需要的事件监听器：

# 在页面导航前设置错误收集器
uncaught_errors = []
page.on("pageerror", lambda exc: uncaught_errors.append(exc))

error_logs = []
page.on("console", lambda msg: error_logs.append(msg.text) if msg.type == "error" else None)

# 然后执行页面导航
page.goto(url, wait_until="networkidle")

# 后续的断言检查
assert len(uncaught_errors) == 0
assert len(error_logs) == 0

技术原理

Playwright的事件监听机制是异步的，但遵循以下原则：

1. 监听器只能捕获注册后发生的事件
2. 页面加载过程中的错误会在加载完成后统一触发
3. 先注册的监听器会先收到事件通知

最佳实践建议

1. 尽早注册监听器：最好在创建页面对象后立即设置错误监听
2. 分类收集错误：区分未捕获异常和普通控制台错误
3. 合理等待：使用wait_until参数确保页面完全加载
4. 错误信息格式化：为断言失败提供清晰的错误信息

扩展应用

这种模式不仅适用于错误捕获，还可以用于：

• 性能指标收集
• 网络请求监控
• 自定义日志记录
• 页面行为分析

通过正确理解Playwright的事件机制，开发者可以构建更健壮的自动化测试套件，有效捕获前端应用的各种运行时问题。