如何基于ComposeTestRule编写自定义匹配器获取下一个兄弟节点？

你可以通过操作Compose的语义树（Semantics Tree）实现需求——先定位目标节点的父节点，再从父节点的子节点列表中找到目标节点的位置，进而获取它的下一个兄弟节点。以下是两种实用的实现方式：

1. 自定义断言匹配器：验证下一个兄弟节点满足指定条件 #

这个匹配器可直接用来断言目标节点的下一个兄弟符合预期特征：

import androidx.compose.ui.test.SemanticsMatcher
import androidx.compose.ui.semantics.SemanticsNode

fun hasNextSibling(matcher: SemanticsMatcher): SemanticsMatcher {
    return SemanticsMatcher("has next sibling that ${matcher.description}") { node ->
        // 无父节点则直接返回false
        val parent = node.parent ?: return@SemanticsMatcher false
        val children = parent.children.toList()
        val currentIndex = children.indexOf(node)
        
        // 检查当前节点不是最后一个子节点，且下一个节点匹配指定条件
        currentIndex != -1 && 
        currentIndex + 1 < children.size && 
        matcher.matches(children[currentIndex + 1])
    }
}

使用示例 #

composeTestRule.onNodeWithText("用户名")
    .assert(hasNextSibling(hasText("张三"))) // 断言"用户名"的下一个兄弟是"张三"

2. 扩展函数：直接定位到下一个兄弟节点 #

如果需要直接对下一个兄弟节点执行操作（比如点击、输入），可以写一个扩展函数快速定位：

import androidx.compose.ui.test.ComposeTestRule
import androidx.compose.ui.test.SemanticsMatcher

fun ComposeTestRule.onNextSiblingOf(targetMatcher: SemanticsMatcher) = onNode(
    SemanticsMatcher("next sibling of ${targetMatcher.description}") { candidateNode ->
        val parent = candidateNode.parent ?: return@SemanticsMatcher false
        val children = parent.children.toList()
        
        // 找到目标节点在子列表中的位置
        val targetNode = children.find { targetMatcher.matches(it) } ?: return@SemanticsMatcher false
        val targetIndex = children.indexOf(targetNode)
        
        // 验证候选节点就是目标节点的下一个兄弟
        targetIndex != -1 && 
        targetIndex + 1 < children.size && 
        children[targetIndex + 1] == candidateNode
    }
)

使用示例 #

composeTestRule.onNextSiblingOf(hasText("编辑按钮"))
    .performClick() // 直接点击"编辑按钮"的下一个兄弟节点
    .assert(hasText("保存")) // 验证该节点文本为"保存"

关键原理说明 #

Compose的每个语义节点（SemanticsNode）都持有parent和children引用，我们通过父节点拿到所有同级子节点的列表，找到目标节点的索引后，就能精准定位到它的下一个兄弟。这种方式比getSiblings更聚焦，只会处理你需要的那个兄弟节点。

内容的提问来源于stack exchange，提问作者sahasra emmanuel