Why Compose UI testing in Android Kotlin? - Purpose & Use Cases

The Big Idea

What if your app could test itself every time you make a change?

The Scenario

Imagine you build an app with many buttons, text fields, and screens. You want to check if every button works and every text shows correctly. Doing this by tapping and looking at the screen yourself every time is tiring and slow.

The Problem

Manually testing your app means you can miss bugs, forget steps, or spend hours repeating the same checks. It's easy to make mistakes and hard to test every detail on different devices or after small changes.

The Solution

Compose UI testing lets you write small programs that automatically tap buttons, enter text, and check what appears on screen. This saves time, finds bugs early, and makes sure your app works well every time you change it.

Before vs After

✗ Before

Open app > Tap button > Check text > Repeat for each screen

✓ After

composeTestRule.onNodeWithText("Login").performClick()
composeTestRule.onNodeWithText("Welcome").assertIsDisplayed()

What It Enables

It enables fast, reliable checks of your app's user interface so you can fix problems before users see them.

Real Life Example

A developer changes the login screen design. With Compose UI testing, they run tests that quickly confirm the login button still works and the welcome message appears, avoiding surprises after release.

Key Takeaways

Manual UI checks are slow and error-prone.

Compose UI testing automates interaction and verification.

This leads to faster development and higher app quality.

Practice

1. What is the main purpose of createComposeRule() in Compose UI testing?

easy

A. To create UI elements dynamically during runtime

B. To set up the environment for testing Compose UI components

C. To launch the app on a physical device

D. To generate random test data for UI tests

Solution

1. Step 1: Understand the role of createComposeRule()

   This function sets up the Compose testing environment so you can test UI components safely and isolated.

2. Step 2: Differentiate from other options

   It does not create UI elements dynamically, launch apps, or generate test data; it only prepares the test rule.

3. Final Answer:

   To set up the environment for testing Compose UI components -> Option B

4. Quick Check:

   Compose test setup = B [OK]

Hint: Remember: createComposeRule sets up Compose test environment [OK]

Common Mistakes:

• Thinking it creates UI elements during app runtime
• Confusing it with launching the app on devices
• Assuming it generates test data automatically

2. Which of the following is the correct way to find a UI element by its text in Compose UI testing?

easy

A. composeTestRule.getElementByText("Hello")

B. composeTestRule.findViewByText("Hello")

C. composeTestRule.selectNode("Hello")

D. composeTestRule.onNodeWithText("Hello")

Solution

1. Step 1: Recall Compose testing API for text search

   The correct method to find a node by text is onNodeWithText().

2. Step 2: Verify other options are invalid

   Methods like findViewByText, getElementByText, and selectNode do not exist in Compose testing.

3. Final Answer:

   composeTestRule.onNodeWithText("Hello") -> Option D

4. Quick Check:

   Find by text = onNodeWithText [OK]

Hint: Use onNodeWithText to find text elements in Compose tests [OK]

Common Mistakes:

• Using Android View testing methods instead of Compose methods
• Trying to use non-existent functions
• Confusing node selectors with view selectors

3. Given this Compose test code snippet:

composeTestRule.setContent {
  Text("Welcome")
}

composeTestRule.onNodeWithText("Welcome").assertExists()

What will happen when this test runs?

medium

A. The test will pass because the text "Welcome" exists

B. The test will fail because the text is not found

C. The test will throw a syntax error

D. The test will pass but not check the text

Solution

1. Step 1: Analyze the UI content set

   The UI contains a Text composable with the string "Welcome".

2. Step 2: Understand the assertion

   assertExists() checks that the node with text "Welcome" is present, which it is.

3. Final Answer:

   The test will pass because the text "Welcome" exists -> Option A

4. Quick Check:

   Text present means assertExists passes [OK]

Hint: assertExists passes if UI text is present exactly [OK]

Common Mistakes:

• Assuming assertExists checks content correctness beyond presence
• Thinking the test fails if no interaction is done
• Confusing syntax errors with runtime test failures

4. Identify the error in this Compose UI test code:

composeTestRule.setContent {
  Button(onClick = {}) {
    Text("Click Me")
  }
}

composeTestRule.onNodeWithTag("button").performClick()

medium

A. performClick() is not a valid Compose test function

B. The Button composable cannot be clicked in tests

C. The node is searched by tag but no tag was set on the Button

D. The Text inside Button should be searched instead of Button

Solution

1. Step 1: Check how the node is found

   The test looks for a node with tag "button" but the Button has no tag set.

2. Step 2: Understand Compose testing tags

   To find by tag, the Button must have Modifier.testTag("button") applied, which is missing.

3. Final Answer:

   The node is searched by tag but no tag was set on the Button -> Option C

4. Quick Check:

   Missing testTag causes node not found [OK]

Hint: Always add testTag modifier to find nodes by tag [OK]

Common Mistakes:

• Assuming performClick works without correct node selection
• Searching text inside Button instead of Button itself
• Thinking performClick is invalid in Compose tests

5. You want to test a Compose screen with a list of items. Each item has a unique test tag like "item_1", "item_2", etc. Which approach correctly verifies that the item with tag "item_3" is displayed and clickable?

hard

A. composeTestRule.onNodeWithTag("item_3").assertIsDisplayed().performClick()

B. composeTestRule.onNodeWithText("item_3").assertIsDisplayed().performClick()

C. composeTestRule.onNodeWithTag("item_3").assertExists().performClick()

D. composeTestRule.onNodeWithContentDescription("item_3").assertIsDisplayed().performClick()

Solution

1. Step 1: Identify correct node selector for test tag

   Use onNodeWithTag("item_3") to find the node by its unique test tag.

2. Step 2: Verify visibility and interaction

   assertIsDisplayed() confirms the node is visible, and performClick() simulates a click.

3. Step 3: Eliminate incorrect options

   Searching by text or content description is wrong here; assertExists() alone doesn't check visibility.

4. Final Answer:

   composeTestRule.onNodeWithTag("item_3").assertIsDisplayed().performClick() -> Option A

5. Quick Check:

   Tag + visible + click = composeTestRule.onNodeWithTag("item_3").assertIsDisplayed().performClick() [OK]

Hint: Use onNodeWithTag + assertIsDisplayed before performClick [OK]

Common Mistakes:

• Using onNodeWithText instead of onNodeWithTag for tags
• Skipping assertIsDisplayed before clicking
• Confusing content description with test tag