GoLand 2025.3 Help

Playwright

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

创建一个新的 Playwright 项目

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

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

  2. 在左侧列表中,选择 Playwright

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

  4. 请指定 Node.js 运行时

  5. 指定安装 Playwright 的命令。

  6. 单击 创建

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

初始化 Playwright 项目

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

项目初始化

开始项目初始化:

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

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

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

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

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

项目初始化成功

基于角色的定位器支持

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

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

基于角色的定位器

添加元素到代码

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

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

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

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

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

    "添加元素到代码"按钮

    要添加特定类型的选择器(IDNameTag with classes 等),请点击 按以下方式将元素添加到代码 并选择所需选项。

    按以下方式将元素添加到代码

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

    选择定位器类型

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

运行测试

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

    或者,将插入符号置于测试类以运行该类中的所有测试,或置于测试方法,然后按 Ctrl+Shift+F10

您可以使用运行/调试配置以更可自定义的方式运行测试。 欲了解更多信息,请参阅 运行测试

在可见模式下运行测试

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

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

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

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

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

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

查看测试结果

测试运行完成后,结果会显示在 运行 工具窗口的 测试运行器 选项卡上。 在此选项卡上,您可以重新运行测试、导出和导入测试结果、查看每个测试的运行耗时以及执行其他操作。

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

欲了解更多信息,请参阅 浏览测试结果

调试测试

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

  1. 为需要暂停执行的代码行设置断点。

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

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

  4. 修复问题。

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

  1. 在装订区域,将鼠标悬停在您希望暂停执行的可执行代码行上,然后点击

    设置断点
  2. 在装订区域中点击 并选择 调试。 这将启动调试器会话并运行您的代码。

  3. 程序命中断点后,执行将被挂起,您可以在 调试 工具窗口中查看调试器会话的结果。

    调试工具窗口概述

有关调试的详细信息,请参阅 调试

生成 Playwright 报告

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

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

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

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

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

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

生成的 Playwright 报告

修改运行/调试配置

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

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

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

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

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

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

最后修改日期: 2025年 12月 5日