XCUI测试：替换sleep实现页面加载完成及内容可见的动态等待

问题背景 #

现有XCUI测试循环代码如下，使用固定sleep(5)等待页面加载，希望替换为动态等待逻辑，确保页面完全加载、内容可见后再执行截图：

for i in 1...1000 {
    sleep(5)
    makeScreenshot(name: "Page-\(i)")
    app.swipeLeft()
}

此前尝试的两种方案均未达预期：

• 使用XCUIApplication().waitForExistence(timeout: 10)：仅判断应用存在，无法确保页面内容渲染完成
• 使用ChatGPT提供的waitForAppQuiescence函数：逻辑存在错误，仍会出现内容未显示就截图的情况，原函数代码：

func waitForAppQuiescence(timeout: TimeInterval) { 
    let quiescenceExpectation = XCTNSPredicateExpectation(predicate: NSPredicate(format: "exists == true"), object: XCUIApplication()) 
    let result = XCTWaiter().wait(for: [quiescenceExpectation], timeout: timeout) 
    if result == .completed { 
        print("Timed out waiting for the app to become quiescent")
    }
}

可行解决方案 #

1. 等待页面核心内容元素可交互（推荐）

waitForExistence仅验证元素存在于DOM，但元素可能未完成渲染或处于不可见状态。改用等待元素的isHittable属性（元素可见且可交互），能更准确判断页面内容是否加载完成。

示例代码：

// 替换为你页面的核心元素查询，比如关键文本、按钮等
func waitForPageContent(timeout: TimeInterval = 10) {
    let contentElement = app.staticTexts["keyPageContent"]
    let expectation = XCTNSPredicateExpectation(predicate: NSPredicate(format: "isHittable == true"), object: contentElement)
    let result = XCTWaiter().wait(for: [expectation], timeout: timeout)
    if result != .completed {
        XCTFail("页面核心内容超时未加载完成")
    }
}

// 修改后的测试循环
for i in 1...1000 {
    waitForPageContent()
    makeScreenshot(name: "Page-\(i)")
    app.swipeLeft()
}

2. 等待加载指示器消失

如果页面有加载动画（如ActivityIndicator），可以等待加载指示器消失，以此判断页面加载完成：

// 替换为实际加载指示器的查询标识
func waitForLoadingComplete(timeout: TimeInterval = 10) {
    let loadingIndicator = app.activityIndicators["loadingSpinner"]
    let expectation = XCTNSPredicateExpectation(predicate: NSPredicate(format: "exists == false"), object: loadingIndicator)
    let result = XCTWaiter().wait(for: [expectation], timeout: timeout)
    if result != .completed {
        XCTFail("加载指示器超时未消失")
    }
}

// 修改后的测试循环
for i in 1...1000 {
    waitForLoadingComplete()
    makeScreenshot(name: "Page-\(i)")
    app.swipeLeft()
}

3. 修正页面静止等待函数

原ChatGPT提供的函数逻辑错误，正确的页面静止等待应验证应用进入运行且静止状态，以下是修正后的实现：

func waitForAppQuiescence(timeout: TimeInterval = 10) {
    let app = XCUIApplication()
    let predicate = NSPredicate(format: "state == %d", XCUIApplication.State.running.rawValue)
    let quiescenceExpectation = XCTNSPredicateExpectation(predicate: predicate, object: app)
    let result = XCTWaiter().wait(for: [quiescenceExpectation], timeout: timeout)
    if result != .completed {
        print("等待应用静止超时")
    }
}

内容的提问来源于stack exchange，提问作者Prashant Kumar