Espresso 测试框架 - 视图匹配器

---

---

Espresso 框架提供了许多视图匹配器。匹配器的目的是使用视图的不同属性（例如 Id、文本和子视图的可用性）来匹配视图。每个匹配器都匹配视图的特定属性并应用于特定类型的视图。例如，withId 匹配器匹配视图的 Id 属性并应用于所有视图，而 withText 匹配器匹配视图的 Text 属性，仅应用于 TextView。

在本章中，让我们学习 Espresso 测试框架提供的不同匹配器，以及学习 Espresso 匹配器构建的基础库 Hamcrest。

Hamcrest 库

Hamcrest 库在 Espresso 测试框架的范围内是一个重要的库。Hamcrest 本身是一个用于编写匹配器对象的框架。Espresso 框架广泛使用 Hamcrest 库，并在必要时对其进行扩展以提供简单且可扩展的匹配器。

Hamcrest 提供了一个简单的函数 assertThat 和一系列匹配器来断言任何对象。assertThat 有三个参数，如下所示：

• 字符串（测试描述，可选）

• 对象（实际值）

• 匹配器（预期值）

让我们编写一个简单的示例来测试列表对象是否具有预期值。

import static org.hamcrest.Matchers.hasItem;
import static org.hamcrest.MatcherAssert.assertThat;
@Test
public void list_hasValue() {
   ArrayList<String> list = new ArrayList<String>();
   list.add("John");
   assertThat("Is list has John?", list, hasItem("John"));
}

这里，hasItem 返回一个匹配器，它检查实际列表是否具有指定值作为其中一项。

Hamcrest 具有许多内置匹配器，以及创建新匹配器的选项。在 Espresso 测试框架中，一些有用的重要内置匹配器如下：

anything - 总是匹配

基于逻辑的匹配器

• allOf - 接受任意数量的匹配器，只有当所有匹配器都成功时才匹配。

• anyOf - 接受任意数量的匹配器，如果任何一个匹配器成功则匹配。

• not - 接受一个匹配器，只有当匹配器失败时才匹配，反之亦然。

基于文本的匹配器

• equalToIgnoringCase - 用于测试实际输入是否等于预期字符串（忽略大小写）。

• equalToIgnoringWhiteSpace - 用于测试实际输入是否等于指定的字符串（忽略大小写和空格）。

• containsString - 用于测试实际输入是否包含指定的字符串。

• endsWith - 用于测试实际输入是否以指定的字符串结尾。

• startsWith - 用于测试实际输入是否以指定的字符串开头。

基于数字的匹配器

• closeTo - 用于测试实际输入是否接近预期数字。

• greaterThan - 用于测试实际输入是否大于预期数字。

• greaterThanOrEqualTo - 用于测试实际输入是否大于或等于预期数字。

• lessThan - 用于测试实际输入是否小于预期数字。

• lessThanOrEqualTo - 用于测试实际输入是否小于或等于预期数字。

基于对象的匹配器

• equalTo - 用于测试实际输入是否等于预期对象。

• hasToString - 用于测试实际输入是否具有 toString 方法。

• instanceOf - 用于测试实际输入是否是预期类的实例。

• isCompatibleType - 用于测试实际输入是否与预期类型兼容。

• notNullValue - 用于测试实际输入是否不为空。

• sameInstance - 用于测试实际输入和预期值是否为同一实例。

• hasProperty - 用于测试实际输入是否具有预期的属性。

is - equalTo 的简写或语法糖

匹配器

Espresso 提供了 onView() 方法来匹配和查找视图。它接受视图匹配器并返回 ViewInteraction 对象以与匹配的视图交互。常用视图匹配器列表如下：

withId()

withId() 接受一个 int 类型的参数，该参数引用视图的 id。它返回一个匹配器，该匹配器使用视图的 id 来匹配视图。示例代码如下：

onView(withId(R.id.testView))

withText()

withText() 接受一个 string 类型的参数，该参数引用视图的文本属性的值。它返回一个匹配器，该匹配器使用视图的文本值来匹配视图。它仅适用于 TextView。示例代码如下：

onView(withText("Hello World!"))

withContentDescription()

withContentDescription() 接受一个 string 类型的参数，该参数引用视图的内容描述属性的值。它返回一个匹配器，该匹配器使用视图的描述来匹配视图。示例代码如下：

onView(withContentDescription("blah"))

我们还可以传递文本值的资源 ID 而不是文本本身。

onView(withContentDescription(R.id.res_id_blah))

hasContentDescription()

hasContentDescription() 没有参数。它返回一个匹配器，该匹配器匹配具有任何内容描述的视图。示例代码如下：

onView(allOf(withId(R.id.my_view_id), hasContentDescription()))

withTagKey()

withTagKey() 接受一个 string 类型的参数，该参数引用视图的标签键。它返回一个匹配器，该匹配器使用其标签键来匹配视图。示例代码如下：

onView(withTagKey("blah"))

我们还可以传递标签名称的资源 ID 而不是标签名称本身。

onView(withTagKey(R.id.res_id_blah))

withTagValue()

withTagValue() 接受一个 Matcher