SwiftUI UI测试中XCUIElementQuery返回计数不一致问题

问题场景 #

在SwiftUI视图的UI测试中，尝试获取带可访问性标识的List内的staticTexts数量时，代码中直接查询返回0，但调试控制台用po命令能得到正确结果：

let pred = NSPredicate(format: "identifier == 'detailViewTable'")
let detailViewTable = app.descendants(matching: .any).matching(pred).firstMatch
let arrOfTexts = detailViewTable.staticTexts
let ct = arrOfTexts.count
print("Count is: \(ct)") // 输出0
print("Count is now: \(detailViewTable.staticTexts.count)") // 同样输出0

对应的SwiftUI视图已通过.accessibility(identifier: "detailViewTable")为List设置标识，断点调试时po detailViewTable.staticTexts.count返回21。

核心原因 #

1. XCUIElementQuery的惰性计算特性
   XCUIElementQuery采用延迟求值逻辑，只有当你实际访问其属性（如count）时才会执行查询。但如果此时List内的子元素还未完成UI渲染或可访问性注册，查询会立即返回当前已识别的元素数（即0）。而调试时手动执行po命令有时间差，子元素已完成加载，因此能得到正确结果。

2. SwiftUI异步渲染与可访问性同步延迟
   SwiftUI的视图渲染、数据加载和可访问性元素的系统注册是异步流程。即使List本身被找到，其内部的staticTexts可能还未被可访问性框架完全识别，导致直接查询计数为0。

解决办法 #

1. 用等待API确保元素就绪 #

通过XCTestExpectation等待staticTexts满足计数条件后再查询：

let detailViewTable = app.tables["detailViewTable"].firstMatch
// 等待表格内至少有1个staticText存在
let textExistsPredicate = NSPredicate(format: "count > 0")
expectation(for: textExistsPredicate, evaluatedWith: detailViewTable.staticTexts, handler: nil)
waitForExpectations(timeout: 5) { error in
    if let error = error {
        print("等待超时: \(error.localizedDescription)")
    }
}

// 此时查询计数
let count = detailViewTable.staticTexts.count
print("正确计数: \(count)")

2. 缩小查询范围 #

避免使用descendants(matching: .any)这种宽泛的查询，直接指定目标元素类型（如.table）提升查询效率和准确性：

// 替代原查询方式，直接定位到table类型元素
let detailViewTable = app.tables["detailViewTable"].firstMatch

3. 确保数据源提前加载 #

在测试开始前，确保List的数据源已完全加载。如果是网络请求或异步数据，可在测试前置步骤中等待数据就绪，再执行UI元素查询。

内容的提问来源于stack exchange，提问作者James Toomey