Android Compose单元测试：如何验证Switch的开关状态？

在Compose中定义了如下Switch组件：

Switch(
    checked = false,
    modifier = Modifier.testTag("mySwitch")
)

尝试在Compose单元测试中验证其状态，测试代码如下：

composeTestRule.onAllNodesWithTag("mySwitch")
    .assertAll(isToggleable() and isOff())

但测试失败，抛出异常：

java.lang.AssertionError: Failed to assertAll((ToggleableState is defined) && (ToggleableState = 'Off'))
Found '1' nodes not matching:
1) Node #8 at (l=955.0, t=387.0, r=1054.0, b=450.0)px, Tag: 'switch'
Has 4 siblings
Selector used: 'TestTag = 'mySwitch''

单独调用assertIsToggleable和assertIsOff断言也均失败，且已确认该Switch在测试的UI状态下可见。

Compose的Switch组件内部结构中，你设置的testTag是绑定在Switch的外层容器节点上，而不是承载Toggleable交互语义的核心可点击节点。容器节点本身不具备Toggleable相关的语义属性，因此用testTag定位到的节点无法满足isToggleable()和isOff()的断言条件，导致测试失败。

方案1：基于现有语义属性定位核心节点（推荐） #

不需要自定义语义，通过容器节点找到内部的核心交互节点即可：

// 方法A：通过testTag定位容器，再获取其子节点（Switch的核心交互节点是容器的直接子节点）
composeTestRule.onNodeWithTag("mySwitch")
    .onChild()
    .assert(isToggleable() and isOff())

// 方法B：如果页面中该Switch是唯一的，可直接通过语义属性匹配状态
composeTestRule.onNode(isToggleable() and isOff())
    .assertExists()

方案2：添加自定义语义属性（适合复杂场景） #

如果页面存在多个Switch，或者需要更明确的状态标记，可以给Switch添加自定义语义属性：

在Composable中定义： #

// 定义全局的自定义语义属性键
val SwitchCheckedStateKey = SemanticsProperties.CustomSemanticsPropertyKey<Boolean>("SwitchCheckedState")

Switch(
    checked = false,
    modifier = Modifier
        .testTag("mySwitch")
        .semantics {
            // 绑定开关状态到自定义语义属性
            set(SwitchCheckedStateKey, false)
        }
)

在测试代码中验证： #

// 复用同一个自定义语义属性键
val SwitchCheckedStateKey = SemanticsProperties.CustomSemanticsPropertyKey<Boolean>("SwitchCheckedState")

composeTestRule.onNodeWithTag("mySwitch")
    .assert(
        hasCustomSemanticsProperty(SwitchCheckedStateKey) and
        hasCustomSemanticsPropertyValue(SwitchCheckedStateKey, false)
    )

不需要强制使用自定义语义，方案1足够应对大多数常规场景；自定义语义更适合页面有多个同类型组件、需要精准区分状态，或者需要扩展额外测试信息的复杂场景。

内容的提问来源于stack exchange，提问作者Mister Smith