使用 Playwright (Java) 等待元素状态变化

本文介绍了在使用 Playwright (Java) 进行自动化测试时，如何可靠地等待页面元素状态发生变化。针对元素始终存在但内容动态更新的场景，提供了一种基于 Awaitility 的解决方案，以避免测试用例的随机性和提高稳定性。

在使用 Playwright 进行 Web 自动化测试时，经常会遇到需要等待页面元素状态发生变化的情况。例如，点击一个按钮后，表格中的数据会更新，或者某个元素的文本内容会改变。直接获取元素状态可能导致测试用例的随机性，因为元素可能在状态改变之前就被读取。page.waitForLoadState() 和 page.waitForSelector() 等方法通常适用于等待页面加载或元素出现，但对于元素内容动态变化的情况，它们可能无法满足需求。

使用 Awaitility 等待元素状态变化

Awaitility 是一个 Java 库，专门用于简化异步操作的测试。它可以让你以一种更具声明性的方式来等待某个条件成立。

立即学习“Java免费学习笔记（深入）”；

首先，需要在你的项目中添加 Awaitility 的依赖。如果你使用 Maven，可以在 pom.xml 文件中添加以下内容：

<dependency>
    <groupId>org.awaitility</groupId>
    <artifactId>awaitility</artifactId>
    <version>4.2.0</version>
    <scope>test</scope>
</dependency>

或者如果你使用 Gradle，可以在 build.gradle 文件中添加以下内容：

腾讯元宝

腾讯混元平台推出的AI助手

223

查看详情

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<Boolean> 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();
        }
    }
}

代码解释：

1. Callable<Boolean> elementStateChanged: 这是一个函数式接口，定义了等待的条件。在这个例子中，我们通过 page.locator("columnSelector").textContent() 获取元素的文本内容，并与期望的新值 "Deactivate" 进行比较。如果相等，则返回 true，表示条件满足，Awaitility 将停止等待。
2. 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 中等待元素状态变化的问题，提高测试用例的稳定性和可靠性。通过定义明确的等待条件和设置合理的超时时间和轮询间隔，可以确保测试用例能够准确地验证应用程序的行为。这种方法特别适用于元素始终存在但内容动态更新的场景。

以上就是使用 Playwright (Java) 等待元素状态变化的详细内容，更多请关注php中文网其它相关文章！