本文介绍了在使用 Playwright (Java) 进行自动化测试时，如何可靠地等待页面元素状态发生变化。针对元素始终存在但内容动态更新的场景，提供了一种基于 Awaitility 的解决方案，以避免测试用例的随机性和提高稳定性。
在使用 Playwright 进行 Web 自动化测试时，经常会遇到需要等待页面元素状态发生变化的情况。例如，点击一个按钮后，表格中的数据会更新，或者某个元素的文本内容会改变。直接获取元素状态可能导致测试用例的随机性，因为元素可能在状态改变之前就被读取。page.waitForLoadState() 和 page.waitForSelector() 等方法通常适用于等待页面加载或元素出现，但对于元素内容动态变化的情况，它们可能无法满足需求。
使用 Awaitility 等待元素状态变化
Awaitility 是一个 Java 库，专门用于简化异步操作的测试。它可以让你以一种更具声明性的方式来等待某个条件成立。
立即学习“Java免费学习笔记（深入）”；
首先，需要在你的项目中添加 Awaitility 的依赖。如果你使用 Maven，可以在 pom.xml 文件中添加以下内容：
org.awaitility awaitility 4.2.0 test
或者如果你使用 Gradle，可以在 build.gradle 文件中添加以下内容：
testImplementation 'org.awaitility:awaitility:4.2.0'
添加依赖后，就可以使用 Awaitility 来等待元素状态变化了。以下是一个示例代码：
import org.awaitility.Awaitility;
import com.microsoft.playwright.*;
import java.time.Duration;
import java.util.concurrent.Callable;
public class WaitForElementStateChange {
public static void main(String[] args) {
try (Playwright playwright = Playwright.create()) {
Browser browser = playwright.chromium().launch();
Page page = browser.newPage();
page.navigate("your_test_page_url");
// 点击 "deactivateButton" 按钮
page.locator("deactivateButton").click();
// 定义一个 Callable 对象，用于检查元素的状态是否发生了变化
Callable elementStateChanged = () -> {
String currentValue = page.locator("columnSelector").textContent();
return currentValue.equals("Deactivate"); // 假设期望的新值为 "Deactivate"
};
// 使用 Awaitility 等待元素状态变化
Awaitility.await()
.atMost(Duration.ofSeconds(30)) // 最多等待 30 秒
.pollInterval(Duration.ofMillis(500)) // 每 500 毫秒轮询一次
.until(elementStateChanged);
System.out.println("Element state changed successfully!");
browser.close();
}
}
} 代码解释：
-
Callable
elementStateChanged : 这是一个函数式接口，定义了等待的条件。在这个例子中，我们通过 page.locator("columnSelector").textContent() 获取元素的文本内容，并与期望的新值 "Deactivate" 进行比较。如果相等，则返回 true，表示条件满足，Awaitility 将停止等待。 -
Awaitility.await(): 这是 Awaitility 的核心方法，用于配置等待行为。
- atMost(Duration.ofSeconds(30)): 设置最大等待时间为 30 秒。如果在 30 秒内条件没有满足，Awaitility 将抛出一个异常。
- pollInterval(Duration.ofMillis(500)): 设置轮询间隔为 500 毫秒。Awaitility 将每隔 500 毫秒执行一次 elementStateChanged 函数，直到条件满足或达到最大等待时间。
- until(elementStateChanged): 指定要等待的条件。
注意事项：
- 替换占位符： 请将代码中的 "your_test_page_url"、"deactivateButton"、"columnSelector" 和 "Deactivate" 替换为你实际的 URL、按钮选择器、列选择器和期望值。
- 调整超时时间和轮询间隔： 根据你的应用程序的性能和网络状况，调整 atMost() 和 pollInterval() 的值。超时时间应该足够长，以确保元素有足够的时间来改变状态，但又不能太长，以免浪费测试时间。轮询间隔应该足够短，以快速检测到状态变化，但又不能太短，以免过度消耗资源。
- 异常处理： Awaitility 在等待超时时会抛出一个异常。你应该在你的测试代码中处理这个异常，以避免测试用例失败。
总结
使用 Awaitility 可以有效地解决 Playwright 中等待元素状态变化的问题，提高测试用例的稳定性和可靠性。通过定义明确的等待条件和设置合理的超时时间和轮询间隔，可以确保测试用例能够准确地验证应用程序的行为。这种方法特别适用于元素始终存在但内容动态更新的场景。
