playwright 自动化框架python教程(十一)[page.on方法详解]

playwright 的page.on方法详解

page.on 方法在 Playwright 中是一个非常重要的接口，它允许你为页面上的各种事件注册监听器。这意味着你可以定义当特定事件发生时执行的回调函数，这对于自动化测试、数据抓取、性能监控等多种场景非常有用。下面是一些常见的使用场景和详细说明：

基本语法

Python

page.on(event, callback)

• event: 字符串，表示你想要监听的事件名称。事件类型包括但不限于 'load', 'domcontentloaded', 'request', 'response', 'dialog', 'popup' 等。
• callback: 回调函数，当指定的事件发生时会被调用。该函数通常接收一个或多个参数，具体取决于所监听的事件类型。

常见事件及用途

1. 'load' 和 'domcontentloaded':

   • load: 页面上的所有资源（如图像、样式表、脚本）加载完毕时触发。
   • domcontentloaded: DOM 树构建完成，但可能还有资源正在加载时触发。常用于确保可以查询页面元素。

2. 'request' 和 'response':

   • request: 当浏览器发送网络请求时触发。
   • response: 当收到网络响应时触发。可用于监听和分析网络请求的详细信息，或者根据响应内容做出决策。

3. 'dialog':

   • 当页面触发JavaScript弹窗（如 alert, confirm, prompt）时触发。通过监听这个事件，你可以自动处理弹窗，比如接受、拒绝或输入值。

4. 'popup':

   • 当页面操作导致新窗口或标签页打开时触发。可以用来监控和控制新打开的页面。

5. 'console':

   • 当页面上的JavaScript代码产生控制台消息时触发。可用于捕捉前端日志信息。

示例

• 监听页面加载完成:

  Python

  page.on("load", lambda _: print("Page loaded!"))

• 监听网络请求:

  Python

  def print_request(request):
      print(f"Request to {request.url} started.")
  
  page.on("request", print_request)

• 处理弹窗:

  Python

  def handle_dialog(dialog):
      if dialog.type == 'alert':
          print(f"Alert message: {dialog.message}")
          dialog.accept()
      
  page.on("dialog", handle_dialog)

注意事项

• 当使用异步API时，回调函数应该是异步的（使用 async def 定义）。
• 不要忘记在不需要时取消事件监听，尤其是进行多次测试时，避免回调累积导致意外行为。
• 通过 page.off(event, callback) 可以移除特定的事件监听器。

通过灵活运用 page.on 方法，你可以对页面的各种行为和状态变化做出响应，从而实现复杂的自动化逻辑。