如何用Selenium编写OrangeHRM管理员门户用户角色下拉框自动化代码？

问题原因 #

你遇到的UnexpectedTagNameException是因为Selenium的Select类仅支持原生HTML的<select>标签，但OrangeHRM的用户角色下拉框是基于<div>实现的自定义组件，直接用Select会触发标签不匹配的异常。

正确实现步骤 #

针对这类自定义下拉框，需要模拟人工操作流程：点击下拉框展开选项 → 等待选项加载完成 → 点击目标选项。

修正后的代码 #

// 1. 点击下拉框触发展开选项列表
WebElement dropdownTrigger = driver.findElement(By.xpath("//div[contains(@class, 'oxd-select-text-input')]/../following-sibling::div/i"));
dropdownTrigger.click();

// 2. 等待选项列表可见，确保元素可交互
WebDriverWait wait = new WebDriverWait(driver, 30);
wait.until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//div[@role='listbox']")));

// 3. 定位并点击目标选项（Admin）
WebElement adminOption = wait.until(ExpectedConditions.elementToBeClickable(By.xpath("//div[@role='option' and text()='Admin']")));
adminOption.click();

代码说明 #

• 放弃硬编码的超长XPath，改用更稳定的属性定位（比如role='listbox'、role='option'，这是OrangeHRM自定义组件的标准属性）
• 等待条件优先用elementToBeClickable，确保元素不仅可见还能被点击，避免元素加载完成但不可交互的问题
• 如果目标选项文本存在空格或格式问题，可替换为contains(text(), 'Admin')进行模糊匹配

额外优化建议 #

可以把下拉框操作封装成通用方法，方便重复调用：

public void selectCustomDropdown(By triggerLocator, By optionLocator) {
    WebDriverWait wait = new WebDriverWait(driver, 30);
    // 点击触发下拉
    wait.until(ExpectedConditions.elementToBeClickable(triggerLocator)).click();
    // 点击目标选项
    wait.until(ExpectedConditions.elementToBeClickable(optionLocator)).click();
}

// 调用示例
selectCustomDropdown(
    By.xpath("//div[contains(@class, 'oxd-select-text-input')]/../following-sibling::div/i"),
    By.xpath("//div[@role='option' and text()='Admin']")
);

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