QAF 本身不原生支持 Selenium 的 @FindAll 注解，但可通过手动调用 PageFactory.initElements() 实现兼容，从而复用 @FindAll、@FindBys 等 Selenium 定位策略来批量匹配满足任一条件的 WebElement。
qaf 本身不原生支持 selenium 的 `@findall` 注解，但可通过手动调用 `pagefactory.initelements()` 实现兼容，从而复用 `@findall`、`@findbys` 等 selenium 定位策略来批量匹配满足任一条件的 webelement。
在 QAF（Qmetry Automation Framework）中，虽然其原生 @FindBy（来自 com.qmetry.qaf.automation.ui.annotations.FindBy）不支持逻辑“或”组合（如同时匹配 class1 或 class2），但框架底层仍兼容 Selenium WebDriver 的注解体系。这意味着你完全可以使用标准 Selenium 的 @FindAll 和 @FindBys —— 只需在页面类构造函数中显式初始化即可。
✅ 正确做法：启用 Selenium 注解支持
首先，在你的页面类（继承自 WebDriverBaseTestPage）中，必须手动调用 PageFactory.initElements(driver, this)。QAF 默认使用自己的元素初始化机制，不会自动触发 Selenium 的 PageFactory，因此这行代码不可或缺：
import org.openqa.selenium.support.PageFactory;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.FindBy;
import org.openqa.selenium.support.FindAll;
import org.openqa.selenium.support.FindBys;
public class MyPage extends WebDriverBaseTestPage<webdrivertestpage> {
// ✅ 使用 @FindAll 实现“class1 OR class2”
@FindAll({
@FindBy(className = "class1"),
@FindBy(className = "class2")
})
private List<webelement> elementsWithEitherClass1OrClass2;
// ✅ 或使用 @FindBys（等价于 AND 逻辑，此处仅作对比）
@FindBys({
@FindBy(tagName = "div"),
@FindBy(css = "[data-testid='item']")
})
private List<webelement> divsWithTestId;
public MyPage() {
// ⚠️ 关键：启用 Selenium 注解解析
PageFactory.initElements(getDriver(), this);
}
}</webelement></webelement></webdrivertestpage>
? 注意事项与最佳实践
-
仅限
WebElement/List<webelement></webelement>字段：@FindAll仅适用于WebElement或泛型为WebElement的List，不支持 QAF 封装的QAFWebElement类型（如需封装能力，建议后续通过QAFWebElement.from(webElement)转换）。 -
避免混合注解冲突：不要在同一字段上混用 QAF 的
@FindBy（com.qmetry...）和 Selenium 的@FindBy（org.openqa.selenium.support...），否则可能导致初始化失败或行为不可预期。 -
性能考量：
@FindAll底层执行的是多次独立查找并合并结果（去重由 WebDriver 自动处理），若元素数量庞大，可考虑改用更高效的 CSS 选择器（如".class1, .class2"）配合单个@FindBy(css = ".class1, .class2")——这是推荐的替代方案，更简洁且性能更优：
@FindBy(css = ".class1, .class2") private List<webelement> elementsWithEitherClass1OrClass2; // ✅ 推荐：一行解决，无需 PageFactory</webelement>
-
QAF 原生增强建议：若需动态条件或复杂逻辑（如“包含 class1 且 data-status=active，或 class2 且 visible”），建议结合
getDriver().findElements(By.xpath(...))手动编写 XPath/CSS，再封装为页面方法，保持可维护性。
总之，QAF 对 Selenium 标准注解具备良好兼容性，只需主动触发 PageFactory 初始化即可解锁 @FindAll 能力；但在多数场景下，优先选用复合 CSS 选择器（, 分隔）是更轻量、稳定且符合 QAF 风格的最佳实践。
