在Perfecto中使用QAFWebDriver无法交互Android移动Web元素

问题背景 #

在Perfecto云环境使用QAFWebDriver进行Android Chrome移动Web自动化测试时，执行元素sendKeys操作时抛出org.openqa.selenium.JavascriptException: javascript error: arguments[0].scrollIntoView is not a function错误，导致登录流程失败。

原因分析 #

从错误日志和配置信息来看，核心原因有两点：

1. Chrome W3C模式未启用：配置中goog:chromeOptions.w3c=false，非W3C模式下元素对象的序列化方式与QAF的自动滚动逻辑不兼容，导致执行scrollIntoView时传入的不是有效的DOM元素对象。
2. QAF自动滚动逻辑兼容性问题：QAF 4.0.0-RC2版本的ElementMetaDataListener在元素交互失败时会自动触发滚动操作，但与Selenium 4.11.0、Appium 8.5.1的组合存在兼容性问题，错误地传递了非DOM元素对象给JS脚本。

解决方案 #

方案1：启用Chrome W3C模式 #

修改perfecto.properties中的配置，在goog:chromeOptions里设置w3c: true，确保元素对象以W3C标准序列化：

driver.name=perfectoDriver
remote.server=https://<your-perfecto-instance>.perfectomobile.com/nexperience/perfectomobile/wd/hub/fast
remote.port=80
perfecto.additional.capabilities={"perfecto:options":{"automationName":"Appium","orientation":"LANDSCAPE","javascriptEnabled":true,
"unicodeKeyboard":true,"deviceName":"R52T509SH3P","browserName":"Chrome",
"securityToken":"<your-token>"},"driverClass":"io.appium.java_client.android.AndroidDriver", "goog:chromeOptions":{"w3c":true}}

方案2：禁用QAF自动滚动功能 #

通过配置关闭QAF的自动滚动监听，避免触发有问题的scrollIntoView调用：
在测试配置文件中添加：

qaf.element.metadata.scroll=false

方案3：升级QAF到稳定版本 #

4.0.0-RC2是候选版本，存在已知兼容性问题，升级到QAF 4.0.0正式版或更高版本，修复与Selenium 4.x的适配问题。

方案4：手动处理元素可见性与滚动 #

在代码中显式等待元素可见，并手动执行滚动操作，绕过QAF的自动滚动逻辑：

QAFWebDriver driver = new BancaTestBasePage().getTestBase().getDriver();

// 处理用户名输入框
QAFWebElement usernameField = driver.findElement(By.name("OpeId"));
new WebDriverWait(driver, Duration.ofSeconds(10))
    .until(ExpectedConditions.visibilityOf(usernameField));
// 手动滚动到元素（确保传入有效DOM元素）
driver.executeScript("arguments[0].scrollIntoView({block: 'center'});", usernameField);
usernameField.sendKeys(username);

// 处理密码输入框
QAFWebElement passwordField = driver.findElement(By.name("Password"));
new WebDriverWait(driver, Duration.ofSeconds(10))
    .until(ExpectedConditions.visibilityOf(passwordField));
passwordField.sendKeys(password);

// 处理登录按钮
QAFWebElement loginBtn = driver.findElement(By.xpath("//input[@type='IMAGE']"));
new WebDriverWait(driver, Duration.ofSeconds(10))
    .until(ExpectedConditions.elementToBeClickable(loginBtn));
loginBtn.click();

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