UI自动化测试框架:Playwright 官方教程(一)—— 快速开始

一、简介

Playwright 是微软开源的现代Web 自动化测试框架,它支持主流浏览器,包括 Chrome、FIreFox、Safari等,同时也支持无头、有头模式。

Playwright 主要的特点如下:

跨浏览器:Playwright 支持所有现代渲染引擎,包括Chromium、WebKit 和 Firefox;

跨平台:在 Windows、Linux 和 MacOS 上进行本地或 CI、无头或有头测试;

跨语言:在 TypeScript、JavaScript、Python、.NET、Java 中使用Playwright API;

测试移动网络:适用于 Android 和 Mobile Safari 的 Google Chrome 原生移动仿真。相同的渲染引擎适用于您的桌面和云端。


二、安装

本文以最常用的 python 语言为例,演示如何安装 Playwright。首先确保已安装好了 3.7 及以上版本的python环境。之后就可以通过 pip 来进行 Playwright 的安装及浏览器等依赖的安装了。具体操作如下:

  • 安装 Playwright
pip install playwright
  • 安装浏览器依赖
playwright install

说明:

  1. 和 selenium 不同,Playwright 无需再手动安装对应浏览器的驱动;
  2. 从上图可以看到,命令执行后,会自动安装 firfox 和 webkit 浏览器。

三、快速开始

3.1 通过 playwright 启动一个浏览器实例,并输出 title

# -*- coding:utf-8 -*-

from playwright.sync_api import sync_playwright


def run(_playwright):
    browser = _playwright.chromium.launch()
    page = browser.new_page()
    page.goto("https://www.toutiao.com")
    print(page.title())
    browser.close()


with sync_playwright() as playwright:
    run(playwright)

运行后得到结果如下:

3.2 定位元素

Playwright 提供了多种方法来定位页面元素,包括CSS选择器、XPath等:

element = page.query_selector("input[name='q']")

3.3 模拟用户操作

Playwright 可以模拟用户进行点击、填写表单、按键等操作:

element.fill("Playwright tutorial")
element.press("Enter")

3.4 页面导航与等待

控制页面跳转,并在操作间添加适当的等待时间以确保页面加载完成

page.goto("https://www.toutiao.com/c/user/token/MS4wLjABAAAAzUw-fZXVeJR7-6FZFXUf1nuRaUYV1RqRaJ6RKLfdaA8/?source=list&log_from=f16373d01cdb4_1748825302120")
page.wait_for_load_state("networkidle")

3.5 处理弹窗与对话框

Playwright 可以监听和操作alert、confirm等对话框。

page.on("dialog", lambda dialog: dialog.accept())

3.6 截图

Playwright 支持截图功能

page.screenshot(path="screenshot.png")

path(可选): 图片保存的路径。如果不提供,则返回截图的字节流。
full_page(布尔值,默认为 False): 如果设为 True,则截取整个页面内容,即使内容超出了视口范围。
clip(字典): 指定截图区域,格式为 {x: int, y: int, width: int, height: int}。
omit_background(布尔值,默认为 False): 如果设为 True,则背景透明。
timeout(可选): 超时时间(以毫秒为单位)。
quality(整数,仅适用于 JPEG 格式): 图片质量,范围从 0 到 100。
type(字符串,默认为 "png"): 图片格式,可以是 "jpeg" 或 "png"。

3.7 异步

Playwright 与支持异步操作,只需改用async_playwright和异步语法即可。

async with async_playwright() as playwright:
    await run(playwright)

这些只是 Playwright 功能的冰山一角。更高级的功能如:跨浏览器测试、处理 iframe、网络请求拦截与修改、多页面管理、复杂用户交互模拟等等,本系列文章将逐步深入的进行介绍。

原文链接:,转发请注明来源!