Playwright Java中waitForCondition方法抛出IllegalStateException异常求助

异常原因 #

这个异常是因为waitForCondition内部的等待机制要求至少有一个可追踪的就绪元素/异步操作，但你的代码直接通过count() == 0做同步判断，没有触发Playwright的元素状态追踪逻辑，导致内部等待机制无有效信号可监听。

修复方案 #

方案1：推荐用法——直接等待元素隐藏 #

利用Playwright内置的元素状态等待API，这是最符合框架设计的方式：

page.locator("#spinner").waitFor(new Locator.WaitForOptions().setState(WaitForSelectorState.HIDDEN));

方案2：调整waitForCondition逻辑 #

如果必须使用waitForCondition，需要确保内部包含Playwright的元素定位操作，让框架能追踪元素状态：

page.waitForCondition(() -> {
    // 显式定位元素，触发Playwright的状态追踪
    Locator spinner = page.locator("#spinner");
    return spinner.count() == 0;
});

补充说明 #

Playwright 1.49.0的waitForCondition底层依赖异步等待动作（比如元素定位、状态检查）来维持等待循环，纯同步的数值判断会让内部逻辑认为没有可等待的就绪条件，从而抛出该异常。优先用方案1，稳定性和性能更优。

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