PhpStorm 2025.2 Help

Playwright

Playwright 是一个开源的测试自动化框架。 它提供了一个高级 API,用于自动化 Chrome、 Firefox 和 Safari 等网络浏览器。

创建一个新的 Playwright 项目

  1. 在主菜单中,进入 文件 | 新建项目.

    或者, 如果您在 欢迎 屏幕上, 点击 新项目

  2. 在左侧列表中选择 Playwright

    创建一个新的 Playwright 项目
  3. 请命名新项目并在必要时更改其位置。

  4. 请指定 Node 解释器

  5. 指定安装 Playwright 的命令。

  6. 点击 创建

根据您所选择的选项创建了一个新项目。

初始化 Playwright 项目

一旦项目创建完成,您需要初始化它。 在此过程中,您将选择所需的语言,安装 Playwright 浏览器,并指定其他设置。

项目初始化

开始项目初始化:

  1. 运行工具窗口 Alt+4 中,按键盘上的上/下箭头按钮选择您要在项目中使用的语言。

  2. 请输入您要放置端到端测试的文件夹名称。

  3. 请指定是否要添加 GitHub Actions 工作流

  4. 指定是否要安装 Playwright 浏览器。

当您指定所有参数时,初始化开始。 系统将通知您,一旦流程完成:

项目初始化成功

基于角色的定位器支持

在 Playwright 中,您可以通过其 角色定位元素。 这有助于准确定位页面上的特定元素,无论是按钮、复选框、标题、链接或其他元素。

PhpStorm 可以生成这些定位器并将其添加到您的代码中,以便您在测试中使用它们。

基于角色的定位器

添加元素到代码

  1. 打开您要添加元素的文件。

  2. 点击 Web Inspector 按钮 窗口右侧栏以打开 Web 检查器 工具栏窗口。

  3. 请在地址栏中指定页面的 URL。

    地址栏控制
  4. 点击 页面中选择元素按钮 并选择您想要在 Web Inspector 中添加的元素。

    选择页面中的元素
  5. 一旦选择了元素,点击 添加元素到代码 将元素添加到代码中。

    "添加元素到代码"按钮

    若要添加特定类型的选择器(IDNameTag with classes等),请点击 通过添加元素到代码 并选择所需选项。

    通过添加元素来编写代码

    如果您想在 CSS 和 XPath 定位器之间切换,请点击 并选择所需的定位器类型。

    选择定位器类型

因此,一段代码被生成并添加到代码编辑器中。

运行测试

  • 运行测试时,点击测试类或测试方法旁边的 “运行”按钮 装订区域图标,然后从列表中选择 运行 选项。

    运行测试

    或者,将文本光标放置在测试类以运行该类中的所有测试,或放置在测试方法,然后按 Ctrl+Shift+F10

您可以使用 run/debug configurations 以更加可定制的方式运行测试。 有关更多信息,请参见 运行测试

在可见模式下运行测试

在有界模式下运行测试使您能够直观地展示 Playwright 如何与网站进行交互。

要在有头模式下运行测试:

  1. 单击运行/调试配置切换器中的当前配置,然后单击 并选择 编辑(E) 选项。

    编辑运行/调试配置
  2. Playwright 选项 字段中,指定 --headed 命令:

    配置运行/调试配置以在 headed mode 运行测试
  3. 应用更改并运行您的测试。

结果,一个浏览器被打开以重现测试中的步骤。

查看测试结果

测试运行结束后,结果将显示在 测试运行器 选项卡的 运行 工具窗口中。 在此选项卡中,您可以重新运行测试、导出和导入测试结果、查看运行每个测试所花费的时间,并执行其他操作。

在运行工具窗口的测试运行器选项卡上显示测试结果

有关更多信息,请参见 探索测试结果

调试测试

一般来说,调试过程包括以下步骤:

  1. 为必须挂起执行的代码行设置断点。

  2. 在调试模式下运行您的代码。

  3. 请使用 Debug 工具窗口分析代码并定位潜在问题。

  4. 解决问题。

要在 IDE 中重现这些步骤,请执行以下操作:

  1. 在装订区域,悬停在您要挂起执行的可执行代码行上,然后点击

    设置断点
  2. 点击 并选择 Debug。 这将启动调试器会话并运行您的代码。

    开始调试会话
  3. 一旦程序触及断点,执行就会暂停,您可以在 Debug 工具窗口中查看调试会话的结果。

    调试工具窗口概述

生成 Playwright 报告

Playwright reporters 提供有关失败测试的详细信息,使您能够更彻底地分析测试执行期间发生的情况。

默认情况下,会生成一个 html 报告,但您可以使用运行/调试配置切换到其他格式。 为此:

  1. 单击运行/调试配置切换器中的当前配置,然后单击 并选择 编辑(E) 选项。

    编辑运行/调试配置
  2. Playwright 选项 字段中,指定所需的 报告者。 例如:

    --reporter=line
  3. 应用更改并运行您的测试。

因此,会生成一份详细报告。

生成的 Playwright 报告

修改运行/调试配置

如果您想修改测试的启动属性,请编辑运行/调试配置:

  1. 点击运行/调试配置切换器中的当前配置,然后选择 编辑配置(R)… 选项。

    选择运行/调试配置
  2. 运行/调试配置 对话框中,选择您想要编辑的配置。

  3. 配置所需的启动属性。

    配置启动属性
  4. 应用更改并点击 确定

有关运行/调试配置的更多信息,请参阅 运行/调试配置

自定义定位器模板

如果您想自定义如何将选定元素添加到代码中,您可以修改模板:

  1. 点击状态栏上的框架名称。 UI 自动化框架 菜单打开了。

    自定义模板
  2. 请选择 自定义模板 选项。

  3. 文件和代码模板 对话框中,从列表中选择所需的框架。

    自定义模板
  4. 重写用于网页元素定位器的代码生成算法。

  5. 点击 确定 以保存更改。

因此,定位器将根据更新的代码生成算法添加到代码中。

最后修改日期: 2025年 9月 26日