Playwright
Playwright 是一个开源的测试自动化框架。 它提供了用于自动化 Chrome、Firefox 和 Safari 等网页浏览器的高级 API。
创建新的 Playwright 项目
在主菜单中，转到 。
或者，如果您在 欢迎 屏幕上，请点击 新建项目。
在左侧列表中选择 Playwright。
为新项目命名，并在必要时更改其位置。
指定 Node 解释器。
指定安装 Playwright 的命令。
点击 创建。
系统将根据您选择的选项创建新项目。
初始化 Playwright 项目
创建项目后，您需要对其进行初始化。 在该过程中，您将选择所需的语言、安装 Playwright 浏览器，并指定其他设置。
要开始项目初始化操作：
在 运行工具窗口 Alt+4 中，按键盘上的上下箭头选择您希望在项目中使用的语言。
输入用于存放端到端测试的文件夹名称。
指定是否要添加 GitHub Actions workflow。
指定是否要安装 Playwright 浏览器。
指定所有参数后，初始化过程将开始。 系统将在过程完成后通知您：
基于角色的定位器支持
在 Playwright 中，您可以根据元素的 role 来定位元素。 这有助于在页面中准确定位某个特定元素，例如按钮、复选框、标题、链接或其他元素。
GoLand 可以生成此类定位器并将其添加到您的代码中，以便在测试中使用。
将元素添加到代码中
打开您要添加元素的文件。
点击右侧边栏上的
，以打开 Web 检查器 工具栏窗口。在地址栏中指定页面的 URL。
点击
，并在 Web Inspector 中选中您希望添加的元素。
选中元素后，点击
即可将元素添加到代码中。
要添加特定类型的选择器（ID、 Name、 带类的标签 等），请点击
并选择所需选项。如果您希望在 CSS 和 XPath 定位器之间切换，请点击
并选择所需的定位器类型。
系统会生成一段代码并将其添加到代码编辑器中。
运行测试
要运行测试，请点击测试类或测试方法旁的
行图标，然后从列表中选择 运行 选项。或者，将光标放置在测试类上以运行该类中的所有测试，或放置在测试方法上，然后按 Ctrl+Shift+F10。
您可以通过运行/调试配置，以更具自定义性的方式运行测试。 有关详细信息，请参阅 运行测试。
以带界面模式运行测试
以带界面模式运行测试可以直观地看到 Playwright 如何与网站交互。
要以带界面模式运行测试：
点击运行/调试配置切换器中的当前配置，然后点击
并选择 编辑(E) 选项。
在 Playwright 选项 字段中，指定
--headed命令：
应用更改并运行测试。
系统将打开浏览器，以重现测试中的操作步骤。
查看测试结果
测试运行完成后，结果将显示在 测试运行器 选项卡的 运行 工具窗口中。 在此选项卡中，您可以重新运行测试、导出和导入测试结果、查看每个测试的运行时间，并执行其他操作。
如需了解详情，请参阅 探索测试结果。
调试测试
通常，调试过程包括以下步骤：
为需要暂停执行的代码行设置断点。
以调试模式运行代码。
使用 调试 工具窗口分析代码并定位潜在问题。
修复问题。
要在 IDE 中复现这些步骤，请执行以下操作：
在边距处，将鼠标悬停在要暂停执行的可执行代码行上，然后点击
。 
单击边距处的
，然后选择 调试。 这将启动调试会话并运行您的代码。程序到达断点后会暂停执行，您可以在 调试 工具窗口中查看调试会话结果。
如需了解有关调试的更多信息，请参阅 调试。
生成 Playwright 报告
Playwright reporters 提供有关失败测试的详细信息，帮助您更深入地分析测试执行过程中发生的情况。
系统会默认生成 html 报告，但您可以通过运行/调试配置切换为其他格式。 操作步骤如下：
点击运行/调试配置切换器中的当前配置，然后单击
并选择 编辑(E) 选项。在 Playwright 选项 字段中，指定所需的 reporter。 例如：
--reporter=line应用更改并运行测试。
系统将生成详细报告。
修改运行/调试配置
如果您想修改测试的启动属性，请编辑运行/调试配置：
点击运行/调试配置切换器中的当前配置，并选择 编辑配置(R)… 选项。
在 运行／调试配置 对话框中，选择要编辑的配置。
配置所需的启动属性。
应用更改后点击 确定。
如需了解有关运行/调试配置的更多信息，请参阅 运行／调试配置。