รายการเอสเพรสโซ

Espresso มีกลไกในการเลื่อนไปยังหรือดำเนินการกับรายการหนึ่งๆ สำหรับรายการ 2 ประเภท ได้แก่ มุมมองอะแดปเตอร์และมุมมองรีไซเคิล

เมื่อจัดการกับรายการ โดยเฉพาะรายการที่สร้างด้วยออบเจ็กต์ RecyclerView หรือ AdapterView มุมมองที่คุณสนใจอาจไม่อยู่บนหน้าจอด้วยซ้ำ เนื่องจากระบบจะแสดงรายการย่อยเพียงไม่กี่รายการและจะรีไซเคิลเมื่อคุณเลื่อนดู ไม่สามารถใช้เมธอด scrollTo() ในกรณีนี้ได้เนื่องจากต้องใช้มุมมองที่มีอยู่

โต้ตอบกับรายการมุมมองอะแดปเตอร์

แทนที่จะใช้เมธอด onView() ให้เริ่มการค้นหาด้วย onData() และระบุตัวจับคู่กับข้อมูลที่สนับสนุนมุมมองที่คุณต้องการจับคู่ Espresso จะทำงานทั้งหมดในการค้นหาแถวในออบเจ็กต์ Adapter และทำให้รายการปรากฏในวิวพอร์ต

จับคู่ข้อมูลโดยใช้ตัวจับคู่มุมมองที่กำหนดเอง

กิจกรรมด้านล่างมี ListView ซึ่งได้รับการสนับสนุนโดย SimpleAdapter ที่เก็บข้อมูลสำหรับแต่ละแถวในออบเจ็กต์ Map<String, Object>

กิจกรรมรายการที่แสดงบนหน้าจอในขณะนี้มีรายการที่มี 23 รายการ แต่ละรายการจะมีตัวเลขซึ่งจัดเก็บเป็นสตริงที่แมปกับตัวเลขอื่น ซึ่งจัดเก็บเป็นออบเจ็กต์แทน

แต่ละแผนที่มี 2 รายการ ได้แก่ คีย์ "STR" ที่มีสตริง เช่น "item: x" และคีย์ "LEN" ที่มี Integer ซึ่งแสดงความยาวของเนื้อหา เช่น

{"STR" : "item: 0", "LEN": 7}

โค้ดสำหรับการคลิกแถวที่มี "item: 50" จะมีลักษณะดังนี้

onData(
    allOf(
        `is`(instanceOf(Map::class.java)),
        hasEntry(equalTo("STR"), `is`("item: 50"))
    )
).perform(click())

โปรดทราบว่า Espresso จะเลื่อนดูรายการโดยอัตโนมัติตามต้องการ

มาแยกชิ้นส่วน Matcher<Object> ภายใน onData() กัน เมธอด is(instanceOf(Map.class)) จะจำกัดการค้นหาให้แคบลงเหลือเฉพาะรายการของ AdapterView ซึ่งได้รับการสนับสนุนโดยออบเจ็กต์ Map

ในกรณีของเรา ลักษณะนี้ของการจับคู่คำค้นหาจะตรงกับทุกแถวของมุมมองรายการ แต่เราต้องการคลิกที่รายการใดรายการหนึ่งโดยเฉพาะ ดังนั้นเราจึงจำกัดการค้นหาให้แคบลงด้วย:

hasEntry(equalTo("STR"), `is`("item: 50"))

Matcher<String, Object> นี้จะจับคู่กับ Map ใดก็ตามที่มีรายการซึ่งมีคีย์ "STR" และค่า "item: 50" เนื่องจากโค้ดที่ใช้ค้นหาข้อมูลนี้มีความยาวและเราต้องการนำไปใช้ซ้ำในตำแหน่งอื่นๆ เรามาเขียน Matcher withItemContent ที่กำหนดเองกัน

return object : BoundedMatcher<Any, Map<*, *>>(Map::class.java) {
    override fun matchesSafely(map: Map<*, *>): Boolean {
        return hasEntry(equalTo("STR"), itemTextMatcher).matches(map)
    }

    override fun describeTo(description: Description) {
        description.appendText("with item content: ")
        itemTextMatcher.describeTo(description)
    }
}

คุณใช้ BoundedMatcher เป็นฐานเนื่องจากต้องการจับคู่เฉพาะออบเจ็กต์ประเภท Map ลบล้างเมธอด matchesSafely() โดยใส่ Matcher ที่พบก่อนหน้านี้ และจับคู่กับ Matcher<String> ที่คุณสามารถส่งเป็นอาร์กิวเมนต์ได้ ซึ่งจะช่วยให้คุณโทรหา withItemContent(equalTo("foo")) ได้ เพื่อให้โค้ดสั้นลง คุณสามารถสร้าง Matcher อื่นที่เรียกใช้ equalTo() อยู่แล้วและยอมรับออบเจ็กต์ String ได้

fun withItemContent(expectedText: String): Matcher<Any> {
    checkNotNull(expectedText)
    return withItemContent(equalTo(expectedText))
}

ตอนนี้โค้ดสำหรับคลิกรายการจะง่ายขึ้น ดังนี้

onData(withItemContent("item: 50")).perform(click())

หากต้องการดูโค้ดทั้งหมดของการทดสอบนี้ ให้ดูเมธอด testClickOnItem50() ภายในคลาส AdapterViewTest และ Matcher ที่กำหนดเองLongListMatchersนี้ใน GitHub

จับคู่หน้าจอสำหรับเด็กที่เฉพาะเจาะจง

ตัวอย่างด้านบนจะคลิกตรงกลางแถวทั้งหมดของ ListView แต่จะทำอย่างไรหากเราต้องการดำเนินการกับรายการย่อยที่เฉพาะเจาะจงของแถว ตัวอย่างเช่น เราต้องการคลิกคอลัมน์ที่ 2 ของแถว LongListActivity ซึ่งแสดง String.length ของเนื้อหาในคอลัมน์แรก

ในตัวอย่างนี้ การดึงข้อมูลเฉพาะความยาวของเนื้อหาหนึ่งๆ จะเป็นประโยชน์ กระบวนการนี้เกี่ยวข้องกับการกำหนดค่าของคอลัมน์ที่ 2 ในแถว

เพียงเพิ่มข้อกำหนด onChildView() ลงในการติดตั้งใช้งาน DataInteraction ดังนี้

onData(withItemContent("item: 60"))
    .onChildView(withId(R.id.item_size))
    .perform(click())

โต้ตอบกับรายการในมุมมอง Recycler

ออบเจ็กต์ RecyclerView ทำงานแตกต่างจากออบเจ็กต์ AdapterView ดังนั้นจึงไม่สามารถใช้ onData() เพื่อโต้ตอบกับออบเจ็กต์ดังกล่าวได้

หากต้องการโต้ตอบกับ RecyclerView โดยใช้ Espresso คุณสามารถใช้แพ็กเกจ espresso-contrib ซึ่งมีคอลเล็กชัน RecyclerViewActions ที่ใช้เลื่อนไปยังตำแหน่งหรือดำเนินการกับรายการได้ ดังนี้

  • scrollTo() - เลื่อนไปยังมุมมองที่ตรงกัน หากมี
  • scrollToHolder() - เลื่อนไปยัง View Holder ที่ตรงกัน หากมี
  • scrollToPosition() - เลื่อนไปยังตำแหน่งที่เฉพาะเจาะจง
  • actionOnHolderItem() - ดำเนินการดูใน View Holder ที่ตรงกัน
  • actionOnItem() - ดำเนินการกับการดูในมุมมองที่ตรงกัน
  • actionOnItemAtPosition() - ดำเนินการ ViewAction ในมุมมองที่ตำแหน่งที่เฉพาะเจาะจง

ข้อมูลโค้ดต่อไปนี้แสดงตัวอย่างบางส่วนจากตัวอย่าง RecyclerViewSample

@Test(expected = PerformException::class)
fun itemWithText_doesNotExist() {
    // Attempt to scroll to an item that contains the special text.
    onView(ViewMatchers.withId(R.id.recyclerView))
        .perform(
            // scrollTo will fail the test if no item matches.
            RecyclerViewActions.scrollTo<RecyclerView.ViewHolder>(
                hasDescendant(withText("not in the list"))
            )
        )
}

@Test fun scrollToItemBelowFold_checkItsText() {
    // First, scroll to the position that needs to be matched and click on it.
    onView(ViewMatchers.withId(R.id.recyclerView))
        .perform(
            RecyclerViewActions.actionOnItemAtPosition(
                ITEM_BELOW_THE_FOLD,
                click()
            )
        )

    // Match the text in an item below the fold and check that it's displayed.
    val itemElementText = "${activityRule.activity.resources
        .getString(R.string.item_element_text)} ${ITEM_BELOW_THE_FOLD.toString()}"
    onView(withText(itemElementText)).check(matches(isDisplayed()))
}
@Test fun itemInMiddleOfList_hasSpecialText() {
    // First, scroll to the view holder using the isInTheMiddle() matcher.
    onView(ViewMatchers.withId(R.id.recyclerView))
        .perform(RecyclerViewActions.scrollToHolder(isInTheMiddle()))

    // Check that the item has the special text.
    val middleElementText = activityRule.activity.resources
            .getString(R.string.middle)
    onView(withText(middleElementText)).check(matches(isDisplayed()))
}

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้รายการ Espresso ในการทดสอบ Android ได้ที่แหล่งข้อมูลต่อไปนี้

ตัวอย่าง

  • DataAdapterSample: แสดงจุดแรกเข้า onData() สำหรับ Espresso, สำหรับรายการ และออบเจ็กต์ AdapterView