本教程旨在解决selenium自动化测试中常见的`by`定位器参数类型不匹配问题，特别是当尝试将一个已封装的`by`对象再次传入`by.id()`或类似方法时出现的`cannot be applied to`编译错误。文章将详细阐述`by`定位器的正确使用方式，强调方法参数类型的重要性，并通过示例代码展示如何避免此类错误，确保定位器被正确地传递给期望`by`类型参数的方法。
在Selenium自动化测试中，org.openqa.selenium.By类是用于定位页面元素的核心工具。它提供了一系列静态方法，如By.id()、By.name()、By.className()、By.xpath()和By.cssSelector()等，用于根据不同的策略来查找元素。然而，初学者在使用这些定位器时，有时会遇到参数类型不匹配的编译错误，例如'id(java.lang.String)' in 'org.openqa.selenium.By' cannot be applied to '(org.openqa.selenium.By)'。本文将深入分析这一错误的原因，并提供正确的解决方案。
1. 理解Selenium的By定位器
By类是Selenium中一个抽象类，它的各个静态方法（如By.id()）返回的是By类的实例。这些实例本身就代表了一个完整的定位策略。例如，By.id("user-name")就创建了一个表示“通过ID属性值为'user-name'来定位元素”的By对象。
这些By对象随后会被传递给WebDriver接口中的方法，如driver.findElement(By locator)或ExpectedConditions类中的方法，如ExpectedConditions.visibilityOfElementLocated(By locator)。这些方法都明确地期望一个By类型的参数。
2. 错误分析：'id(java.lang.String)' cannot be applied to '(org.openqa.selenium.By)'
这个错误信息清晰地指出了问题所在：By.id()方法期望一个java.lang.String类型的参数（即元素的ID值），但你却传入了一个org.openqa.selenium.By类型的参数。
让我们通过一个具体的代码示例来理解这个问题：
public class LoginPage extends BasePage {
// ...
public By getUserNameLocator(){
return By.id("user-name"); // 此方法返回一个By对象
}
public boolean isLoaded(){
// 错误发生在这里：By.id()被传入了一个By对象
return wait.until(ExpectedConditions.visibilityOfElementLocated(By.id(getUserNameLocator()))).isDisplayed();
}
public void login(String username, String password) {
// 错误发生在这里：By.id()被传入了一个By对象
driver.findElement(By.id(getUserNameLocator())).sendKeys(username);
// ...
}
}在上述代码中：
- getUserNameLocator()方法已经返回了一个By对象，例如By.id("user-name")。
- 在isLoaded()方法中，ExpectedConditions.visibilityOfElementLocated()方法本身就期望一个By对象作为参数。然而，代码却尝试将其再次包裹在By.id()中，即By.id(getUserNameLocator())。此时，By.id()方法接收到的参数是getUserNameLocator()返回的By对象，而不是它所期望的String类型的ID值。
- 同样的问题也出现在login()方法中的driver.findElement(By.id(getUserNameLocator()))。driver.findElement()期望一个By对象，但这里又错误地将getUserNameLocator()返回的By对象作为参数传给了By.id()。
简而言之，你正在尝试对一个已经构造好的By对象再次进行“构造”，而By.id()方法的设计并非如此。它只接受原始的定位字符串（如ID值、类名等）。
3. 正确使用By定位器的方法
解决这个问题的关键在于理解方法签名和参数类型。当一个方法（如driver.findElement()或ExpectedConditions.visibilityOfElementLocated()）期望一个By类型的参数时，你应当直接传入已经构造好的By对象。
以下是修正后的代码示例：
package adta;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
// 假设BasePage中已初始化WebDriverWait wait对象
public class LoginPage extends BasePage {
public LoginPage(WebDriver driver) {
super(driver);
}
// 此方法用于封装用户名输入框的定位器，返回一个By对象
public By getUserNameLocator(){
return By.id("user-name");
}
public void open(){
driver.get("https://www.saucedemo.com/");
}
public boolean isLoaded(){
// 修正点：ExpectedConditions.visibilityOfElementLocated() 直接接收By对象
// 无需再次调用 By.id()
return wait.until(ExpectedConditions.visibilityOfElementLocated(getUserNameLocator())).isDisplayed();
}
public void login(String username, String password) {
// 修正点：driver.findElement() 直接接收By对象
// 无需再次调用 By.id()
driver.findElement(getUserNameLocator()).sendKeys(username);
// 对于其他直接使用字符串ID的定位器，保持原样是正确的
driver.findElement(By.id("password")).sendKeys(password);
driver.findElement(By.id("login-button")).click();
}
}在修正后的代码中：
- isLoaded()方法现在直接将getUserNameLocator()返回的By对象传递给ExpectedConditions.visibilityOfElementLocated()。
- login()方法也直接将getUserNameLocator()返回的By对象传递给driver.findElement()。
这样，所有方法都接收到了它们期望的参数类型，编译错误自然就解决了。
4. 注意事项与最佳实践
- 严格匹配参数类型： 始终检查你正在调用的方法的签名，确保传入的参数类型与方法期望的参数类型完全一致。这是避免此类编译错误最基本也是最重要的原则。
- 封装定位器的优势： 将定位器封装在单独的方法中（如getUserNameLocator()）是良好的自动化测试实践。它提高了代码的可读性和可维护性。当页面元素的定位策略发生变化时，你只需要修改一个地方（即getUserNameLocator()方法内部），而无需修改所有使用该定位器的地方。
- 避免冗余操作： 一旦你通过By.id("someId")等方法成功创建了一个By对象，就直接使用它。不要再尝试用By.id()或其他By构造方法去“包裹”或“重新构造”这个已经存在的By对象。
- 理解By方法的返回值： 所有的By静态方法（id, name, className等）都返回一个By类型的对象。这个对象本身就是定位器，可以直接用于findElement()或ExpectedConditions等方法。
通过遵循这些原则和最佳实践，你将能够更有效地使用Selenium的By定位器，避免常见的类型不匹配错误，并编写出更健壮、可维护的自动化测试代码。
