Playwright需在page.goto()前注册page.on("console")监听器以捕获console.log日志，通过msg.text()和msg.type()获取内容与类型，避免直接str()；未捕获异常用page.on("pageerror")，网络错误用page.on("requestfailed")或检查response.status()。
Playwright如何捕获console.log等前端日志
Playwright本身不自动暴露浏览器控制台日志，必须显式启用page.on("console")监听器，且需在页面加载前注册——晚于page.goto()再绑定，会漏掉初始脚本输出的日志。
关键点在于：日志事件对象msg是ConsoleMessage实例，不能直接str()或json.dumps()，得调用msg.text()取内容，用msg.type()区分"log"、"error"、"warn"等类型。
- 监听必须在
page.goto()之前完成，推荐在page = context.new_page()后立即注册 -
msg.args()返回JS值的Python封装（如JSHandle），要取原始值需链式调用.json_value()或.text()，但仅对简单类型安全；复杂对象建议用msg.location()辅助定位问题位置 - 避免在回调里做耗时操作（如写文件），否则可能阻塞页面渲染；应先存入内存列表，结束后统一处理
保存日志到文件的可靠方式
直接在console事件回调中写文件容易因异步竞争导致内容错乱或丢失。更稳妥的做法是把日志结构化暂存，例如用list[dict]记录{"type": "...", "text": "...", "timestamp": time.time()}，最后一次性序列化到JSON或按行追加到文本文件。
- JSON格式适合后续分析，但注意
msg.text()可能含换行符或不可见字符，建议用repr()包裹或预处理 - 若需保留原始时间戳，用
msg.page().context().browser().version无法获取，得靠Python侧time.time()或datetime.now() - 不要用
print()代替保存——它只输出到终端，且可能被CI环境截断
捕获未捕获异常（unhandled exception）和网络错误
page.on("console")抓不到JS运行时抛出的未捕获异常，这类错误走的是page.on("pageerror")通道；而前端fetch失败、资源404等网络问题则需监听page.on("response")并检查response.status()，或监听page.on("requestfailed")。
-
pageerror事件参数是Error对象，error.message和error.stack可直接读取字符串 -
requestfailed事件里的request.failure()返回str（如"net::ERR_CONNECTION_REFUSED"），不是异常实例 - 这三个事件（
console、pageerror、requestfailed）应一并注册，否则日志链条不完整
为什么有些console.log没被捕获到？
常见原因不是Playwright配置问题，而是前端代码执行时机早于监听器注册，或者日志被console.clear()清空后不可追溯。另外，某些框架（如Vue 3的开发模式）会把console重定向到自定义实现，绕过原生API。
- 确保监听器在
page.goto()前注册，且没有await page.wait_for_load_state("networkidle")之类的延迟掩盖问题 - 如果页面使用了Webpack HMR或Vite热更新，部分日志可能出现在模块初始化阶段，需配合
page.on("framenavigated")重新绑定监听器 - 移动端模拟下，Safari WebKit对
console.table()等高级方法支持有限，msg.type()可能返回"log"而非"table"，别依赖类型精确匹配
真正难处理的不是监听本身，而是日志上下文缺失：你看到一行"Failed to fetch"，但不知道它来自哪个fetch()调用、哪个组件、哪次用户操作。这时候得结合msg.location()的url和lineNumber，再配合page.on("request")打点，才能串起完整链路。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
