Playwright
Playwright 是一个开源测试自动化框架。 它提供用于自动化 Chrome、Firefox、Safari 等 Web 浏览器的高级 API。
创建新的 Playwright 项目
在主菜单中,转到 。
或者,如果您位于 欢迎 屏幕,请在左侧窗格中点击 新建 | 新建项目。
在左侧的列表中,选择 Playwright。

为新项目命名,并在必要时更改其位置。
指定 Node.js 运行时。
指定安装 Playwright 的命令。
点击 创建。
在主菜单中,转到 。
或者,如果您位于 欢迎 屏幕,请在左侧窗格中点击 新建 | 新建项目。
在左侧的列表中,选择 适用于 Python 的 Playwright。

为新项目命名,并在必要时更改其位置。
(可选)启用 创建Git 仓库 选项,将新项目置于版本控制之下。 如果您现在不想这样做,您可以随时在以后进行。
选择是创建新的还是使用现有的 环境 ,并配置相应设置。

从列表中选择基础解释器,或点击
,在文件系统中找到 Python 可执行文件。
在 位置 字段中指定新虚拟环境的位置,或点击
,在文件系统中浏览位置。 新虚拟环境的目录应为空。
如果您希望将计算机上全局 Python 中安装的所有软件包添加到要创建的虚拟环境中,请选中 从基础解释器继承包 复选框。 此复选框对应 virtualenv 工具的
--system-site-packages选项。如果您希望在 PyCharm 中创建 Python 解释器时重用此环境,请选中 对所有项目可用 复选框。
有关详细信息,请参阅 配置 virtualenv 环境。

在 位置 字段中指定新 conda 环境的位置,或点击
,在文件系统中浏览位置。 新 conda 环境的目录应为空。
从列表中选择 Python 版本。
PyCharm 将检测 conda 安装。
如果 PyCharm 未自动检测到该安装,请指定 conda 可执行文件的位置,或点击
进行浏览。
有关详细信息,请参阅 配置一个 Conda 虚拟环境。

从列表中选择基础解释器,或点击
,在文件系统中找到 Python 可执行文件。
如果您已将基础二进制目录添加到
PATH环境变量,则无需设置任何其他选项:将自动检测 pipenv 可执行文件的路径。如果 PyCharm 未检测到 pipenv 可执行文件,请点击 通过 pip 安装 pipenv ,允许 PyCharm 为您自动安装它。
或者,按照 pipenv 安装过程查找可执行文件路径,然后在对话框中指定它。
有关详细信息,请参阅 配置 pipenv 环境。

从列表中选择解释器。 如果没有可用的解释器,请点击 添加解释器 ,并根据您的需要进行配置。
点击 创建。
根据您选择的选项创建新项目。
初始化 Playwright 项目
一旦创建项目,您需要对其进行初始化。 在此过程中,您将选择所需的语言,安装 Playwright 浏览器,并指定其他设置。

要开始项目初始化:
在 运行工具窗口 Alt+4 中,按键盘上的上/下方向键选择您希望在项目中使用的语言。
输入要放置端到端测试的文件夹名称。
指定是否要添加 GitHub Actions 工作流。
指定是否要安装 Playwright 浏览器。
指定完所有参数后,将开始初始化。 流程完成后,系统会通知您:

支持基于角色的定位器
在 Playwright 中,您可以根据其 角色 定位元素。 这有助于精确定位页面上的特定元素,无论是按钮、复选框、标题、链接还是其他元素。
PyCharm 可以生成此类定位器并将其添加到您的代码中,以便您在测试中使用。

将元素添加到代码
打开您要添加元素的文件。
在右侧边栏点击
,打开 Web 检查器 工具栏窗口。
在地址栏中指定页面的 URL。

点击
,并在 Web Inspector 中选择您要添加的元素。

选择元素后,点击
将该元素添加到代码中。

要添加特定类型的选择器(ID、 Name、 带类的标签 等),点击
并选择所需选项。

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

随后将生成一段代码并将其添加到代码编辑器中。
运行测试
要运行测试,请点击测试类或测试方法旁的
边栏图标,然后从列表中选择 运行 选项。
或者,将插入符号置于测试类以运行该类中的所有测试,或置于测试方法处,然后按 Ctrl+Shift+F10。
您可以使用运行/调试配置以更可定制的方式运行测试。 有关详细信息,请参阅 运行测试。
在有界面模式下运行测试
在有界面模式下运行测试,可直观展示 Playwright 与网站的交互方式。
要在有界面模式下运行测试:
在运行/调试配置切换器中点击当前配置,然后点击
并选择 编辑(E) 选项。

在 Playwright 选项 字段中指定
--headed命令:
应用更改并运行测试。
在运行/调试配置切换器中点击当前配置,然后点击
并选择 编辑(E) 选项。

在 附加参数 字段中指定
--headed命令:
应用更改并运行测试。
因此将打开浏览器以重现测试中的步骤。
查看测试结果
当测试运行结束时,结果将显示在 运行 工具窗口的 测试运行器 选项卡上。 在此选项卡上,您可以重新运行测试、导出和导入测试结果、查看运行每个测试所花费的时间,以及执行其他操作。

有关详细信息,请参阅 浏览测试结果。
调试测试
通常,调试过程包括以下步骤:
在必须暂停执行的代码行设置断点。
在调试模式下运行代码。
使用 调试 工具窗口分析代码并定位潜在问题。
修复问题。
要在 IDE 中复现这些步骤,请执行以下操作:
在边栏中,将鼠标悬停在您希望暂停执行的可执行代码行上,然后点击
。

在边栏中点击
,并选择 调试。 这将启动调试器会话并运行您的代码。
一旦程序命中断点,执行将被挂起,您可以在 调试 工具窗口中查看调试器会话的结果。

有关调试的更多信息,请参阅 调试。
生成 Playwright 报告
Playwright 报告器 提供有关失败测试的详细信息,从而更全面地分析测试执行期间发生的情况。
默认情况下,将生成 html 报告,但您可以使用运行/调试配置切换为其他格式。 为此:
在运行/调试配置切换器中点击当前配置,然后点击
并选择 编辑(E) 选项。

在 Playwright 选项 字段中指定所需的 报告器。 例如:
--reporter=line应用更改并运行测试。
将生成详细报告。

修改运行/调试配置
如果您想修改测试的启动属性,请编辑运行/调试配置:
在运行/调试配置切换器中点击当前配置,并选择 编辑配置(R)… 选项。

在 运行/调试配置 对话框中,选择您要编辑的配置。
配置所需的启动属性。


应用更改并点击 确定。
有关运行/调试配置的更多信息,请参阅 运行/调试配置。
自定义定位器模板
如果您想自定义将选定元素添加到代码的方式,可以修改模板:
点击状态栏中的框架名称。 将打开 UI 自动化框架 菜单。

选择 自定义模板 选项。
在 文件与代码模板 对话框中,从列表中选择所需框架。

重写 Web 元素定位器的代码生成算法。
点击 确定 以保存更改。
因此,将根据更新后的代码生成算法把定位器添加到代码中。
