WebStorm 2025.2 Help

Web UI 测试自动化

WebStorm 中的 Web UI 测试自动化功能由 Test Automation 插件提供。 该插件有助于开发和维护自动化 UI 测试,并且是 Aqua 提供的重要功能之一,Aqua 是 JetBrains 专为测试自动化打造的独立 IDE。

Test Automation 插件提供以下功能:

有关测试自动化功能的更多信息,请参阅 官方 Aqua 文档

安装 Test Automation 插件

  1. 设置 对话框(Ctrl+Alt+S )中,选择 插件

  2. 切换到 插件市场 选项卡,输入 Test Automation ,然后单击 安装

    正在安装 Test Automation 插件
  3. 点击 应用 以保存更改并关闭对话框。 如果系统提示,请重启 IDE。

测试自动化功能

测试识别

当您打开项目时,WebStorm 会自动识别使用 Cypress 或 Playwright 编写的测试。 识别到的测试可通过单击边距中的 运行图标 图标运行,然后使用 IDE 工具进行 分析调试

查看测试
查看测试

代码辅助功能

提供的编码辅助功能包括智能 代码补全导航语法高亮 、对特定框架函数和表达式的支持等。

例如,您可以在代码编辑器中开始输入定位器或其子字符串,自动补全功能将为您提供可选元素列表。 此外,所选元素将在 Web Inspector 中高亮显示,方便您选择正确的定位器。

定位器生成与验证

Web Inspector 工具窗口使您能够查看 Web 应用并 捕获自动化测试所需的页面元素。 当您在网页上选择所需元素时,WebStorm 会生成唯一的 CSS 或 XPath 定位器,并帮助您将其 添加到源代码中。

此外,WebStorm 还能生成 Playwright 中使用的 基于角色的定位器。 这些定位器旨在反映元素的角色(例如,按钮或复选框),从而简化识别。

基于角色的定位器

此外, Web Inspector 还能帮助您 验证代码中的定位器是否有效并是否指向网页上的正确元素。 点击代码编辑器中定位器旁边的 图标将打开 Web Inspector 并选择相应元素,从而验证定位器。

管理测试的运行/调试配置

运行/调试配置是一组启动属性,用于定义执行内容,以及在执行过程中应使用的参数和环境。

您可以为测试创建多组 配置 ,并根据需要立即切换。

管理测试运行配置
管理测试运行配置

测试执行详情

测试完成后,系统会提供详尽的结果信息,包括每个测试的日志和控制台输出,方便您 查看。 您可以筛选结果,以便快速浏览失败或被忽略的测试并分析其执行时间。

查看测试结果
查看测试结果

调试器

调试器是用于测试和排查代码的工具。 它可以让您逐步运行代码,并提供每一步发生的详细信息。

Playwright 测试的调试器开箱即用。 您可以设置 断点以暂停执行并分析代码。

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