一、简介
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
说明:
- 和 selenium 不同,Playwright 无需再手动安装对应浏览器的驱动;
- 从上图可以看到,命令执行后,会自动安装 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、网络请求拦截与修改、多页面管理、复杂用户交互模拟等等,本系列文章将逐步深入的进行介绍。