一、简介

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、网络请求拦截与修改、多页面管理、复杂用户交互模拟等等，本系列文章将逐步深入的进行介绍。