Espresso มีกลไกในการเลื่อนไปยังหรือดำเนินการกับรายการหนึ่งๆ สำหรับรายการ 2 ประเภท ได้แก่ มุมมองอะแดปเตอร์และมุมมองรีไซเคิล
เมื่อจัดการกับรายการ โดยเฉพาะรายการที่สร้างด้วยออบเจ็กต์ RecyclerView หรือ AdapterView มุมมองที่คุณสนใจอาจไม่อยู่บนหน้าจอด้วยซ้ำ เนื่องจากระบบจะแสดงรายการย่อยเพียงไม่กี่รายการและจะรีไซเคิลเมื่อคุณเลื่อนดู ไม่สามารถใช้เมธอด scrollTo() ในกรณีนี้ได้เนื่องจากต้องใช้มุมมองที่มีอยู่
โต้ตอบกับรายการมุมมองอะแดปเตอร์
แทนที่จะใช้เมธอด onView() ให้เริ่มการค้นหาด้วย onData() และระบุตัวจับคู่กับข้อมูลที่สนับสนุนมุมมองที่คุณต้องการจับคู่
Espresso จะทำงานทั้งหมดในการค้นหาแถวในออบเจ็กต์ Adapter และทำให้รายการปรากฏในวิวพอร์ต
จับคู่ข้อมูลโดยใช้ตัวจับคู่มุมมองที่กำหนดเอง
กิจกรรมด้านล่างมี ListView ซึ่งได้รับการสนับสนุนโดย SimpleAdapter ที่เก็บข้อมูลสำหรับแต่ละแถวในออบเจ็กต์ Map<String, Object>

แต่ละแผนที่มี 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 ของเนื้อหาในคอลัมน์แรก

เพียงเพิ่มข้อกำหนด 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