移动端UI自动化：如何等待多行显示的指定文本？

现有适用于单行文本的等待方法：

public void screen_heading_should_be(String scrheading) {
        Wait<WebDriver> fluentWait = new FluentWait<WebDriver>(ldriver)
                .withTimeout(Duration.ofSeconds(10))
                .pollingEvery(Duration.ofSeconds(1));
        fluentWait.until(ExpectedConditions.textToBe(AppiumBy.id("screen_heading"), scrheading));
    }

当前遇到的场景：

• UI中的目标文本会因设备屏幕尺寸/分辨率不同，显示为两行、三行甚至更多行（比如原文本含换行逻辑"Please set your course <br/> preferences to proceed."）
• 测试用例传入的scrheading是单行友好字符串："Please set your course preferences to proceed."
• 尝试过用screen_heading.getText().replaceAll("\r\n|\r|\n", " ")处理文本，但ExpectedConditions.textToBe()仅接受By定位器，无法直接传入处理后的字符串

核心思路是通过自定义等待条件，先获取元素文本并做标准化处理（移除所有换行、合并多余空格），再和目标单行字符串匹配。

方法1：直接在等待逻辑中处理 #

public void screen_heading_should_be(String scrheading) {
    Wait<WebDriver> fluentWait = new FluentWait<WebDriver>(ldriver)
            .withTimeout(Duration.ofSeconds(10))
            .pollingEvery(Duration.ofSeconds(1));
            
    fluentWait.until(driver -> {
        WebElement heading = driver.findElement(AppiumBy.id("screen_heading"));
        // 移除所有换行符，合并连续空格，再去除首尾空白
        String processedText = heading.getText()
                .replaceAll("\\r\\n|\\r|\\n", " ")
                .trim()
                .replaceAll("\\s+", " ");
        return processedText.equals(scrheading);
    });
}

方法2：封装可复用的等待条件 #

如果需要在多个测试步骤中复用，可以把文本处理逻辑封装成独立的ExpectedCondition：

public static ExpectedCondition<Boolean> textToBeAfterNormalizingWhitespace(By locator, String expectedText) {
    return driver -> {
        try {
            WebElement element = driver.findElement(locator);
            String actualText = element.getText()
                    .replaceAll("\\r\\n|\\r|\\n", " ")
                    .trim()
                    .replaceAll("\\s+", " ");
            return actualText.equals(expectedText);
        } catch (NoSuchElementException | StaleElementReferenceException e) {
            // 元素未找到或状态过期时，返回false继续等待
            return false;
        }
    };
}

调用示例：

public void screen_heading_should_be(String scrheading) {
    Wait<WebDriver> fluentWait = new FluentWait<WebDriver>(ldriver)
            .withTimeout(Duration.ofSeconds(10))
            .pollingEvery(Duration.ofSeconds(1));
            
    fluentWait.until(textToBeAfterNormalizingWhitespace(AppiumBy.id("screen_heading"), scrheading));
}

补充说明 #

• 额外处理连续空格是为了避免UI排版导致的文本差异（比如换行后自动产生的多个空格）
• 捕获元素相关异常，确保等待过程中元素状态变化时不会直接终止等待

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