Тестирование API

Существует три основных способа взаимодействия с элементами пользовательского интерфейса:

• Средства поиска позволяют выбрать один или несколько элементов (или узлов в семантическом дереве), чтобы делать утверждения или выполнять над ними действия.
• Утверждения используются для проверки существования элементов или наличия определенных атрибутов.
• Действия внедряют в элементы моделируемые пользовательские события, такие как щелчки или другие жесты.

Некоторые из этих API принимают SemanticsMatcher для ссылки на один или несколько узлов в семантическом дереве.

Искатели

Вы можете использовать onNode и onAllNodes для выбора одного или нескольких узлов соответственно, но вы также можете использовать удобные средства поиска для наиболее распространенных поисков, таких как onNodeWithText и onNodeWithContentDescription . Полный список можно просмотреть в шпаргалке Compose Testing .

Выберите один узел

composeTestRule.onNode(<<SemanticsMatcher>>, useUnmergedTree = false): SemanticsNodeInteraction

// Example
composeTestRule
    .onNode(hasText("Button")) // Equivalent to onNodeWithText("Button")

Выберите несколько узлов

composeTestRule
    .onAllNodes(<<SemanticsMatcher>>): SemanticsNodeInteractionCollection

// Example
composeTestRule
    .onAllNodes(hasText("Button")) // Equivalent to onAllNodesWithText("Button")

Необъединенное дерево

Некоторые узлы объединяют семантическую информацию своих дочерних узлов. Например, кнопка с двумя текстовыми элементами объединяет метки текстовых элементов:

MyButton {
    Text("Hello")
    Text("World")
}

В тесте используйте printToLog() чтобы отобразить дерево семантики:

composeTestRule.onRoot().printToLog("TAG")

Этот код печатает следующий вывод:

Node #1 at (...)px
 |-Node #2 at (...)px
   Role = 'Button'
   Text = '[Hello, World]'
   Actions = [OnClick, GetTextLayoutResult]
   MergeDescendants = 'true'

Если вам нужно сопоставить узел того, что будет несвязанным деревом, вы можете установить для useUnmergedTree значение true :

composeTestRule.onRoot(useUnmergedTree = true).printToLog("TAG")

Этот код печатает следующий вывод:

Node #1 at (...)px
 |-Node #2 at (...)px
   OnClick = '...'
   MergeDescendants = 'true'
    |-Node #3 at (...)px
    | Text = '[Hello]'
    |-Node #5 at (83.0, 86.0, 191.0, 135.0)px
      Text = '[World]'

Параметр useUnmergedTree доступен во всех средствах поиска. Например, здесь он используется в средстве поиска onNodeWithText .

composeTestRule
    .onNodeWithText("World", useUnmergedTree = true).assertIsDisplayed()

Утверждения

Проверьте утверждения, вызвав assert() для SemanticsNodeInteraction , возвращаемого средством поиска с одним или несколькими сопоставителями:

// Single matcher:
composeTestRule
    .onNode(matcher)
    .assert(hasText("Button")) // hasText is a SemanticsMatcher

// Multiple matchers can use and / or
composeTestRule
    .onNode(matcher).assert(hasText("Button") or hasText("Button2"))

Вы также можете использовать удобные функции для наиболее распространенных утверждений, такие как assertExists , assertIsDisplayed и assertTextEquals . Полный список можно просмотреть в шпаргалке Compose Testing .

Существуют также функции для проверки утверждений в коллекции узлов:

// Check number of matched nodes
composeTestRule
    .onAllNodesWithContentDescription("Beatle").assertCountEquals(4)
// At least one matches
composeTestRule
    .onAllNodesWithContentDescription("Beatle").assertAny(hasTestTag("Drummer"))
// All of them match
composeTestRule
    .onAllNodesWithContentDescription("Beatle").assertAll(hasClickAction())

Действия

Чтобы внедрить действие в узел, вызовите функцию perform…() :

composeTestRule.onNode(...).performClick()

Вот несколько примеров действий:

performClick(),
performSemanticsAction(key),
performKeyPress(keyEvent),
performGesture { swipeLeft() }

Полный список можно просмотреть в шпаргалке Compose Testing .

Матчеры

Для тестирования вашего кода Compose доступны различные средства сопоставления.

Иерархические сопоставители

Иерархические средства сопоставления позволяют перемещаться вверх или вниз по семантическому дереву и выполнять сопоставление.

fun hasParent(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnySibling(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyAncestor(matcher: SemanticsMatcher): SemanticsMatcher
fun hasAnyDescendant(matcher: SemanticsMatcher):  SemanticsMatcher

Вот несколько примеров использования этих сопоставителей:

composeTestRule.onNode(hasParent(hasText("Button")))
    .assertIsDisplayed()

Селекторы

Альтернативный способ создания тестов — использование селекторов , которые могут сделать некоторые тесты более читабельными.

composeTestRule.onNode(hasTestTag("Players"))
    .onChildren()
    .filter(hasClickAction())
    .assertCountEquals(4)
    .onFirst()
    .assert(hasText("John"))

Полный список можно просмотреть в шпаргалке Compose Testing .

Дополнительные ресурсы

• Тестирование приложений на Android . На главной целевой странице тестирования Android представлено более широкое представление об основах и методах тестирования.
• Основы тестирования . Узнайте больше об основных концепциях тестирования приложений для Android.
• Локальные тесты : некоторые тесты можно запускать локально, на своей рабочей станции.
• Инструментальные тесты . Рекомендуется также проводить инструментальные тесты. То есть тесты, которые запускаются непосредственно на устройстве.
• Непрерывная интеграция . Непрерывная интеграция позволяет интегрировать тесты в конвейер развертывания.
• Тестируйте разные размеры экрана . Поскольку пользователям доступно множество устройств, вам следует протестировать разные размеры экрана.
• Espresso : Хотя знания Espresso предназначены для пользовательских интерфейсов на основе View, они все же могут быть полезны для некоторых аспектов тестирования Compose.