您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Selenium 元素定位策略大全：八大定位器優劣對比與實戰選型指南

編輯：Java 相關知識

八大標準定位器

定位器	By 方法	優點	缺點	推薦指數
ID	`By.id("kw")`	唯一、最快、W3C 標準推薦	開發常忘加或動態生成	⭐⭐⭐⭐⭐
Name	`By.name("q")`	表單元素常有、相對穩定	可能重複、非唯一	⭐⭐⭐⭐
Class Name	`By.className("btn")`	樣式類常固定	極易重複、組合類名需用 CSS/XPath	⭐⭐
Tag Name	`By.tagName("input")`	無屬性時兜底	極不精準、需配合屬性過濾	⭐
Link Text	`By.linkText("登入")`	超鏈接文字直觀	文字常變、多語言、重複	⭐⭐
Partial Link Text	`By.partialLinkText("登")`	模糊匹配	同 Link Text，更易匹配錯誤	⭐
CSS Selector	`By.cssSelector("#kw")`	語法豐富、效能好、前端熟悉	極複雜結構寫法晦澀	⭐⭐⭐⭐⭐
XPath	`By.xpath("//input[@id='kw']")`	最強大、支援父/兄/文本/軸向查找	效能較慢、脆弱 (結構微調即失效)	⭐⭐⭐

選型決策樹

有 id → **直接用 ID**。
無 id，有穩定 name → **用 Name**。
表單/按鈕有獨特 data-testid / data-cy → **用 CSS `[data-testid='xxx']`** (最佳實踐：開發專門為測試加屬性)。
需按文本/層級/兄弟關係定位 → **用 XPath** (如 //button[text()='提交']、//label[text()='用戶名']/following-sibling::input)。
其他情況 → **用 CSS Selector** (如 .form-group > input[name='email']、tr:nth-child(3) td:last-child)。

進階 CSS Selector 技巧

// 多類名
button.btn-primary.btn-lg

// 屬性包含/開頭/結尾
input[name*='user']   // 包含
input[name^='first']  // 開頭
input[name$='name']   // 結尾

// 偽類
tr:nth-child(2)       // 第2行
tr:nth-of-type(odd)   // 奇數行
input:not([disabled]) // 未禁用

// 組合
form#login > div.field > input[type='text']

進階 XPath 技巧

// 文本匹配 (含空白處理)
//button[normalize-space()='提交']
//span[contains(text(),'錯誤')]

// 屬性與邏輯
//input[@type='text' and @name='email']
//div[@class='panel' or @class='card']

// 軸向
//label[text()='密碼']/following-sibling::input[1]
//ul/li[last()]
//table//tr[position() > 1]  // 跳過表頭

// 動態 ID 兜底
//div[starts-with(@id, 'user-') and ends-with(@id, '-panel')]

隱式等待 vs 顯式等待

禁用隱式等待 (driver.manage().timeouts().implicitlyWait(0))。
全程使用 顯式等待：

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement el = wait.until(ExpectedConditions.elementToBeClickable(By.id("submit")));
el.click();

Page Object Model (POM) 封裝建議

public class LoginPage {
    private final WebDriver driver;
    private final By username = By.cssSelector("input[name='username']");
    private final By password = By.cssSelector("input[name='password']");
    private final By submit = By.cssSelector("button[type='submit']");

    public LoginPage(WebDriver driver) { this.driver = driver; }

    public void login(String user, String pwd) {
        driver.findElement(username).sendKeys(user);
        driver.findElement(password).sendKeys(pwd);
        driver.findElement(submit).click();
    }
}