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