本文为霍格沃兹测试开发学社学员学习笔记，人工智能测试开发进阶学习文末加群。

一， Playwright 简介

• Web 自动化测试框架。
• 跨平台多语言支持。
• 支持 Chromium、Firefox、WebKit 等主流浏览器自动化操作。
• Playwright 官网：https://playwright.dev/java/docs/intro

二，Playwright 的优点

• 支持所有流行的浏览器。
• 速度更快，更可靠的执行。
• 更强大的自动化测试配置。
• 强大的工具库：Codegen、Playwright inspector、Trace Viewer。

三， Playwright 原理

四， Playwright 与 Selenium 的区别

五，Playwright 核心工具

• Codegen：通过记录你的操作来生成测试。 将它们保存为任何语言。
• Playwright inspector： 检查页面、生成选择器、逐步执行测试、查看点击点、探索执行日志。
• Trace Viewer：捕获所有信息以调查测试失败。 Playwright 跟踪包含测试执行截屏、实时 DOM 快照、动作资源管理器、测试源等等。

六， Playwright 环境安装

1，在 pom.xml 中添加依赖

<dependencies>
    <dependency>
      <groupId>com.microsoft.playwright</groupId>
      <artifactId>playwright</artifactId>
      <version>1.51.0</version>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.10.1</version>
        <!-- References to interface static methods are allowed only at source level 1.8 or above -->
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
  </build>

2， 创建一个项目，编译并执行

package org.ceshiren;

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;
import java.nio.file.Paths;

//1，需要在项目跟目录下执行
//2,执行命令：mvn compile exec:java -D exec.mainClass="org.ceshiren.App"
//3，如果是第一次执行会需要下载依赖的浏览器，所以耗时会比较久
public class App {
    public static void main(String[] args) {
        try (Playwright playwright = Playwright.create()) {
            //启动浏览器，这里默认是无头模式
            Browser browser = playwright.webkit().launch();
//            Browser browser = playwright.chromium().launch();
            //打开页面
            Page page = browser.newPage();
            //访问网页
            page.navigate("https://ceshiren.com/");
            //截图
            page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("example.png")));
            //打印页面标题
            System.out.println(page.title());
        }
    }
}

七， Codegen 基本使用

1，参数设置

# 设定展示窗口大小
mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen --viewport-size=800,600 网页地址"
# 指定设备
mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen --device='iPhone 11' 网页地址"

其他参数：https://playwright.dev/java/docs/codegen#running-codegen

• 执行mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen --viewport-size=800,600 ceshiren.com" 命令后，页面如下：

2，保存登录状态

• 场景：单点登录、验证码问题。

# 保存登录状态
mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen  --save-storage=auth.json"

# 加载认证信息
mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen --load-storage=auth.json github.com/microsoft/playwright"

• 执行 mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen --save-storage=auth.json" 命令，会弹出空白网页，输入ceshiren.com打开页面进行登陆； 登陆成功后手动点击两次关闭页面，项目目录下会自动生成 auth.json 文件保存登陆信息

• 执行 mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="codegen --load-storage=auth.json ceshiren.com" 命令，再次打开同网页，直接进入登陆后的页面。

八， Playwright 常用API

• 链接地址：https://playwright.dev/java/docs/input

• 代码示例

import com.microsoft.playwright.*;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.nio.file.Paths;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class PlaywrightTest {
    static Playwright playwright;

    @BeforeAll
    static void setUpClass() {
        playwright = Playwright.create();
    }

    @Test
    void test() {
        //指定打开谷歌浏览器，默认无头模式
        Browser browser = playwright.chromium().launch(new BrowserType.LaunchOptions().setHeadless(false));
        //打开页面
        Page page = browser.newPage();
        //访问页面
        page.navigate("https://ceshiren.com/");
        //点击搜索按钮
        page.locator("#search-button").click();
        //输入搜索内容
        page.locator("#search-term").fill("Appium");
        //按下回车键
        page.keyboard().down("Enter");
        //获取搜索结果的第一条
        String title = page.locator(".results .item:nth-child(1) .topic-title").innerText();
        System.out.println(title);
        //截图
        page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("screenshot.png")));
        //断言
        assertTrue(title.contains("appium"));
    }
}

九， Trace Viewer 使用

1，通过代码将执行的用例生成trace对应的zip包

import com.microsoft.playwright.*;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.nio.file.Paths;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class PlaywrightTraceTest {
    static Playwright playwright;

    @BeforeAll
    static void setUpClass() {
        playwright = Playwright.create();
    }

    @Test
    void test() {
        Browser browser = playwright.chromium().launch(new BrowserType.LaunchOptions().setHeadless(false));
        //创建一个context的实例
        BrowserContext context = browser.newContext();
        // 添加trace配置
        context.tracing().start(new Tracing.StartOptions()
                .setScreenshots(true)
                .setSnapshots(true)
                .setSources(true));
        //打开页面，page实例来自于上面声明的context实例
        Page page = context.newPage();
        //访问页面
        page.navigate("https://ceshiren.com/");
        //点击搜索按钮
        page.locator("#search-button").click();
        //输入搜索内容
        page.locator("#search-term").fill("Appium");
        //按下回车键
        page.keyboard().down("Enter");
        //获取搜索结果的第一条
        String title = page.locator(".results .item:nth-child(1) .topic-title").innerText();
        System.out.println(title);
        //截图
        page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("ceshiren.png")));
        // 测试用例执行完成之后结束trace，生成trace 文件
        context.tracing().stop(new Tracing.StopOptions()
                .setPath(Paths.get("hogwarts.zip")));
        //断言
        assertTrue(title.contains("appium"));
    }
}

2， 打开trace对应的zip包

• 执行命令： mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="show-trace hogwarts.zip"
• 页面展示代码用例执行的每一个步骤