文档帮助

内容

术语、图标和标签 访问级别 成员类型 成员语法 成员标志 类图标 成员图标 导航和功能 类成员快速导航菜单 Getter 和 Setter 方法 历史记录栏 搜索和筛选 API 文档类元数据 展开和折叠示例和类成员 桌面 -vs- 移动视图 查看类源

术语、图标和标签

许多类在使用配置对象创建（实例化）类时使用快捷名称。快捷名称称为别名（如果类扩展 Ext.Component，则称为xtype）。对于适用的类，别名/xtype 会列在类名称旁边，以便快速参考。

访问级别

框架类或其成员可以指定为私有或受保护。否则，类/成员为公有。公有、受保护和私有是访问描述符，用于传达如何以及何时使用类或类成员。

成员类型

成员语法

下面是一个示例类成员，我们可以对其进行剖析以显示类成员的语法（在这种情况下，从 Ext.button.Button 类中查看的 lookupComponent 方法）。

Ext.container.Container
查看源
lookupComponent ( item ) : Ext.Component
受保护

当在初始化items配置期间或添加新项时将原始配置对象添加到此容器中，或者{@link #insert 插入}时调用。

此方法将传递的对象转换为实例化子组件。

当需要对子项创建应用特殊处理时，可以在子类中覆盖此方法。

参数

项目： 对象

正在添加的配置对象。

返回
Ext.Component

要添加的组件。

我们来看看成员行中的每一部分

成员标志

API 文档使用许多标志来进一步传达类成员的功能和意图。标签可以用文本标签、缩写或图标表示。

类图标

- 表示框架类

- 单例框架类。*有关更多信息，请参见单例标志

- 组件类型框架类（Ext JS 框架中任何扩展 Ext.Component 的类）

- 表示类、成员或指南在当前查看的版本中是新的

成员图标

- 表示类型为 config 的类成员

- 表示类型为 property 的类成员

- 表示类型为 method 的类成员

- 表示类型为 event 的类成员

- 表示类型为 theme variable 的类成员

- 表示类型为 theme mixin 的类成员

- 表示类、成员或指南在当前查看的版本中是新的

类成员快速导航菜单

在 API 文档页面上的类名正下方是一行按钮，对应于当前类拥有的成员类型。每个按钮按类型显示成员数（此计数在应用筛选器时更新）。单击按钮将导航到该成员部分。将鼠标悬停在成员类型按钮上将显示一个弹出菜单，其中包含该类型的全部成员，以便快速导航。

Getter 和 Setter 方法

与类配置选项相关的 Getter 和 Setter 方法将显示在方法部分以及 API 文档和成员类型菜单的配置部分中，它们位于其处理的配置正下方。Getter 和 Setter 方法文档将位于配置行中，以便于参考。

历史记录栏

您的页面历史记录保存在本地存储中，并显示在顶部标题栏正下方（使用可用空间）。默认情况下，仅显示与您当前正在查看的产品/版本匹配的搜索结果。您可以通过单击历史记录栏右侧的 按钮并选择“全部”单选选项来展开显示内容。这将在历史记录栏中显示所有产品/版本的所有近期页面。

在历史记录配置菜单中，您还将看到您最近访问的页面列表。结果按“当前产品/版本”和“全部”单选选项进行筛选。单击 按钮将清除历史记录栏以及保存在本地存储中的历史记录。

如果在历史记录配置菜单中选择了“全部”，则“在历史记录栏中显示产品详细信息”复选框选项将被启用。选中后，每个历史页面的产品/版本将与历史记录栏中的页面名称一起显示。将光标悬停在历史记录栏中的页面名称上也会将产品/版本显示为工具提示。

搜索和筛选器

可以使用页面顶部的搜索字段搜索 API 文档和指南。

在 API 文档页面上，还有一个筛选器输入字段，它使用筛选器字符串筛选成员行。除了按字符串筛选外，您还可以按访问级别、继承和只读筛选类成员。这是使用页面顶部的复选框完成的。

API 类导航树底部的复选框筛选类列表，以包括或排除私有类。

单击空搜索字段将显示您最近 10 次搜索，以便快速导航。

API 文档类元数据

每个 API 文档页面（Javascript 原始页面除外）都有一个菜单视图，其中包含与该类相关的元数据。此元数据视图将具有以下一项或多项

展开和折叠示例和类成员

可运行示例（Fiddles）默认在页面上展开。您可以使用代码块左上角的箭头单独折叠和展开示例代码块。您还可以使用页面右上角的切换按钮切换所有示例的折叠状态。切换所有状态将在页面加载之间记住。

类成员默认在页面上折叠。您可以使用成员行左侧的箭头图标或全局使用右上角的展开/折叠所有切换按钮展开和折叠成员。

桌面 -vs- 移动视图

在较窄的屏幕或浏览器上查看文档将导致针对较小尺寸优化视图。桌面和“移动”视图之间的主要区别是

查看类源

可以通过单击 API 文档页面顶部的类名来查看类源。可以通过单击成员行右侧的“查看源”链接来查看类成员的源。

WebTestIt


顶部

内容

创建页面对象 页面对象选项卡 创建页面对象操作 操作 执行 执行鼠标 按索引元素 获取 是 不是 构建页面对象

使用 Sencha WebTestIt 管理页面对象

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

提示

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

创建页面对象

页面对象是项目中包含元素和利用这些元素的一组动作的类。要创建新的页面对象，请右键单击项目选项卡中的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 操作列表：GDisplays 页面对象的public方法及其返回值。右键单击操作的名称，然后选择跳转到代码位置以直接滚动到代码编辑器中的定义

创建页面对象操作

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

  1. 使用活动页面对象，找到元素选项卡。

  2. 将您希望作为操作基础的元素拖动到代码选项卡中。

  3. 在您希望插入新方法的位置释放鼠标。

  4. 从弹出菜单中，选择您希望该方法基于的操作。

  5. Sencha WebTestIt 将创建一个反映该操作的方法。

  6. 您可以继续自由编辑操作，或将更多元素拖动到新生成的方法中。

借助此功能，您可以在定义页面对象时节省编写代码的数量。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)。

执行鼠标

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

按索引获取元素

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

注意

基于枚举器的元素的一个示例是您可以下载用于 Java 或 TypeScript 的演示网店中的产品列表。每个产品都显示为其自己的组件，项目数量是可变的。在这样的情况下，基于 ID 的选择器通常不可行。

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

在 Sencha WebTestIt 中，我们引入了 获取/是/不是命令来获取要检查的数据，例如元素的值、文本、属性等，而不是 Selenese 中常见的 断言和验证命令。使用这些新命令，获取的数据将从测试中分离出来，这是使用页面对象时推荐的做法。这意味着页面对象包含用于获取数据的获取/是/不是命令，而测试则对其进行验证。

获取

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

是

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

不是

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

构建页面对象

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

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

这就是将元素保存在其专用页面对象中作为私有元素的良好做法的原因。作为测试人员，您只对操作感兴趣，而操作应该是公开可访问的。

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

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

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

WebTestIt