WebTestIt

显示私有类

使用 Sencha WebTestIt 管理页面对象

Sencha WebTestIt 为您提供了强大的页面对象创建和管理工具。您可以使用元素直接在 Sencha WebTestIt 中生成页面对象操作。使用页面对象模式，您可以将 Web 应用程序的行为建模为简单的对象，并执行页面对象操作，例如“单击”、“sendKeys”等，以构建逻辑用户交互。

提示

尽管名称如此，页面对象模式不一定对应于网站或应用程序上的整个“页面”，而是对应于页面上的重要组件，例如标题、菜单或内容区域。创建页面对象时，请为每个组件创建一个单独的页面对象，而不是为整个页面或多个页面创建一个。

创建页面对象

页面对象是项目中的一个类，其中包含元素和一组利用这些元素的操作。要创建新的页面对象，请右键单击项目选项卡中的 test/pageobjects 文件夹，然后从上下文菜单中选择新建 > 页面对象。

注意

虽然我们建议保留默认项目结构，但您可以在任何喜欢的文件夹中创建页面对象，只要您保留 特殊标头。

或者，您可以使用键盘快捷键 Ctrl+N > Ctrl+P。Sencha WebTestIt 将创建一个新的页面对象文件，并等待您命名它。单击ENTER 创建新类。

提示

最佳实践是创建以 Po 作为后缀的页面对象类，例如 Java 和 Typescript 中的 DetailPagePo 或 Python 中的 detail_page_po。

每个页面对象都使用默认函数 open 和 getTitle 生成，这些函数派生自模板系统。

您在项目选项卡中选择的页面对象将成为活动页面对象。Sencha WebTestIt 会根据当前活动的页面对象类调整用户界面并在各种选项卡中显示信息。

页面对象选项卡

当您从项目选项卡中选择页面对象时，Sencha WebTestIt 将打开页面对象选项卡。您可以使用页面对象选项卡导航活动页面对象中的操作。

1 页面对象名称：显示当前活动页面对象的名称。

2 操作列表：显示页面对象的公共方法及其返回值。右键单击操作的名称，然后选择跳转到代码位置以直接滚动到代码编辑器中的定义

创建页面对象操作

要快速创建页面对象操作，您可以使用 Sencha WebTestIt 模板。

在活动页面对象中，找到元素选项卡。
将要作为操作基础的元素拖到代码选项卡中。
在要插入新方法的位置释放鼠标。
从弹出菜单中，选择要使方法基于的操作。
Sencha WebTestIt 将创建一个反映操作的方法。
您可以继续自由编辑操作，或将更多元素拖到新生成的方法中。

感谢此功能，您可以节省在定义页面对象时必须编写的代码量。Sencha WebTestIt 为您提供了一组开箱即用的操作，它是 Selenium IDE 中使用的 Selenese 命令的子集，以帮助测试各种元素、操作和与 Web 应用程序相关的许多其他功能。

操作

操作是与网站或应用程序中的元素交互的简单起点。以下操作可从 Sencha WebTestIt 中的弹出菜单中使用

执行

名称	描述
单击元素	标准的 Selenium `click()` 元素方法，用于对给定元素执行单击操作。
双击元素	从 Selenium `Actions()` 类中的给定元素调用鼠标 `doubleclick()` 方法。
输入元素	调用 `sendKeys(text)` 方法，允许您发送输入字符串以模拟在元素中键入。
清除并输入元素	首先调用 `clear()` 方法，该方法清除输入字段。然后是 `sendKeys(text)` 方法，该方法将输入字符串发送到元素并模拟在元素中键入。
悬停在元素上方	将鼠标光标移动到给定元素的中心，模拟悬停在元素上方的操作。
提交表单	如果给定元素是表单或表单内的元素，则执行提交到远程服务器操作。
切换到 iframe 元素	允许用户切换到位于 iframe 中的元素，并在位于该 iframe 内的元素上执行操作。
滚动到元素	允许用户将指定的元素滚动到浏览器窗口的可见区域。
带偏移量滚动到元素	滚动到目标元素，并额外滚动给定为偏移坐标 (x, y) 的像素数。请注意，负值表示向左 (-x) 或向上 (-y)。

执行鼠标操作

名称	描述
按下	模拟鼠标单击并按住操作。将鼠标光标移动到给定元素的中心，并执行单击并按住（不释放）鼠标左键。
抬起	模拟在给定元素中间释放单击的鼠标按钮。
移动	将鼠标光标移动到给定元素的中心。
悬停	通过将鼠标光标移动到给定元素上方来模拟 mouseover 事件。
移出	通过给定的偏移量将鼠标光标从当前 (X, Y) 位置移开到所需位置。

按索引元素

如果将鼠标悬停在按索引元素弹出菜单条目上，您会找到一组基于枚举器的操作。这些操作生成专门针对列表和其他类似元素集合的方法。

注意

基于枚举器的元素的示例是 Demo Webshop 中的产品列表，您可以下载 Java 或 TypeScript 版本。每个产品都显示为自己的组件，并且项目数量是可变的。在这些情况下，基于 ID 的选择器通常不可行。

名称	描述
单击第 n 个元素	单击列表中的第 n 个项目。存储所有找到的元素，并使用元素的索引单击列表中选定的元素。
获取第 n 个元素	从 WebElement 列表中返回第 n 个项目。创建 Web 元素列表，并使用元素的索引从列表中选择并返回元素。
获取第 n 个元素的文本	从列表中返回第 n 个项目的文本。创建 Web 元素列表，并使用元素的索引从列表中返回选定元素的文本。

Sencha WebTestIt 中引入了 Get/Is/Is not 命令，而不是 Selenese 中常见的 Assert 和 Verify 命令，以获取要检查的数据，例如元素的 value、text、attribute 等。使用这些新命令，获取的数据将与测试分离，这是使用页面对象时推荐的做法。这意味着页面对象包含 Get/It/Is not 命令来获取数据，而测试验证数据。

获取

名称	描述
元素作为变量	将选定的元素作为 WebElement 返回，以便您可以向其添加自定义操作和方法。
元素的文本	使用 `.getText()` 方法返回包含可见元素内部文本的字符串。
元素的值	使用 `getAttribute("value")` 方法返回“elements”的 value 属性。
元素的属性	使您可以使用 `getAttribute()` 方法检索特定的元素属性，例如 value、type 等。
元素选定的值	从给定的（“select”类型）元素（例如，选择列表）返回第一个选定的选项。如果 WebElement 不是“select”类型，则会抛出异常。
元素选定的标签	使用 Selenium `Select()` 类返回一个字符串，其中包含给定“select”类型元素（例如，选择列表）中第一个选定选项的标签（文本）。如果 WebElement 不是“select”类型，则会抛出异常。

是

名称	描述
元素已选中	确定给定元素是否已选中。返回布尔值。仅适用于输入元素，例如复选框、单选按钮、选择标记中的选项。
元素可编辑	确定给定元素是否可编辑。在检查元素是否在网页中启用且具有等于 null 的“readonly”属性后，返回布尔值。
元素存在	确定给定元素是否存在于网页上。在检查找到的具有提供选择器的元素数量是否大于 0 后，返回布尔值。
元素可见	确定给定元素在网页上是否可见。在使用元素上的 `isDisplayed()` 方法后返回布尔值。

不是

名称	描述
元素已选中	确定给定元素是否未选中。返回布尔值。仅适用于输入元素，例如复选框、单选按钮、选择标记中的选项。
元素可编辑	确定给定元素是否不可编辑。在检查元素是否在网页中禁用且具有不等于 null 的“readonly”属性后，返回布尔值。
元素存在	确定给定元素是否不存在于网页上。在检查找到的具有提供选择器的元素数量是否等于 0 后，返回布尔值。
元素可见	确定给定元素在网页上是否不可见（是否隐藏）。在使用元素上的 `isDisplayed()` 方法后返回布尔值。

组织页面对象

强烈建议在设计测试和页面对象时牢记测试维护。我们建议您实施页面对象模式以保持一切井然有序。

页面对象为您提供了封装特定于您的网站或应用程序的元素和操作的绝佳可能性。如果元素损坏（例如，选择器未返回元素），您可以在相应的页面对象中编辑选择器。您的测试用例负责编排这些操作并评估结果。

这就是为什么最佳实践是将元素保存在其专用页面对象中设为私有的原因。作为测试人员，您只对应该公开访问的操作感兴趣。

重定向和站点更改呢？假设您正在表单上输入数据并将其发送出去，这会导致您的客户端重定向到另一个页面。在这种情况下，适当的操作应返回新的页面对象。

测试所需的页面对象数量很大程度上取决于您的网站或应用程序的结构。我们建议分析整体结构并将您的网站或应用程序分解为组件。然后为您识别的每个组件创建一个页面对象。但是，如果一开始某些东西不完美，请不要担心。始终可以重构您的页面对象。

有关页面对象模式的更多信息，请单击此处。

目录

术语、图标和标签

访问级别

成员类型

成员语法

成员标志

类图标

成员图标

导航和功能

类成员快速导航菜单

Getter 和 Setter 方法

历史记录栏

搜索和过滤器

API 文档类元数据

展开和折叠示例和类成员

桌面 -vs- 移动视图

查看类源代码

WebTestIt

目录

使用 Sencha WebTestIt 管理页面对象

创建页面对象

页面对象选项卡

创建页面对象操作

操作

执行

执行鼠标操作

按索引元素

获取

是

不是

组织页面对象

WebTestIt