在使用 Selenium 进行 Web 自动化测试时，经常会遇到各种异常情况。了解这些异常并掌握如何处理它们对于编写稳定可靠的测试脚本至关重要。本文将详细介绍 Selenium 中常见和不常见的异常类及其使用场景。
Selenium 常见异常类列表
| 序号 | 异常类 | 基类 | 描述 |
|---|---|---|---|
| 1 | selenium.common.exceptions.WebDriverException | exceptions.Exception | WebDriver 基础的异常类。所有其他异常类均继承自该类。 |
| 2 | selenium.common.exceptions.TimeoutException | selenium.common.exceptions.WebDriverException | 当一条命令在规定时间内未完成时抛出该异常。 |
| 3 | selenium.common.exceptions.StaleElementReferenceException | selenium.common.exceptions.WebDriverException | 当引用的元素已经过时（即不再存在于页面的 DOM 中）时抛出该异常。 |
| 4 | selenium.common.exceptions.NoSuchElementException | selenium.common.exceptions.WebDriverException | 当无法找到元素时抛出该异常。 |
| 5 | selenium.common.exceptions.NoSuchAttributeException | selenium.common.exceptions.WebDriverException | 当元素的属性无法找到时抛出该异常。 |
| 6 | selenium.common.exceptions.NoAlertPresentException | selenium.common.exceptions.WebDriverException | 当尝试操作一个不存在的 alert 弹窗时抛出该异常。 |
| 7 | selenium.common.exceptions.NoSuchFrameException | selenium.common.exceptions.InvalidSwitchToTargetException | 当尝试切换到一个不存在的 iframe 窗口时抛出该异常。 |
| 8 | selenium.common.exceptions.InvalidElementStateException | selenium.common.exceptions.WebDriverException | 当元素状态无效时抛出该异常。 |
| 9 | selenium.common.exceptions.ElementNotSelectableException | selenium.common.exceptions.InvalidElementStateException | 当尝试选择一个不可选的元素时抛出该异常。 |
| 10 | selenium.common.exceptions.ElementNotVisibleException | selenium.common.exceptions.InvalidElementStateException | 当元素存在于 DOM 树中但不可见时抛出该异常。 |
Selenium 不常见异常类
| 序号 | 异常类 | 基类 | 描述 |
|---|---|---|---|
| 1 | selenium.common.exceptions.ErrorInResponseException | selenium.common.exceptions.WebDriverException | 当服务器端出现错误时抛出该异常，通常由 Firefox 插件或远程 server 引起。 |
| 2 | selenium.common.exceptions.ImeActivationFailedException | selenium.common.exceptions.WebDriverException | 当输入法激活失败时抛出该异常。 |
| 3 | selenium.common.exceptions.ImeNotAvailableException | selenium.common.exceptions.WebDriverException | 当输入法不支持时抛出该异常。 |
| 4 | selenium.common.exceptions.InvalidCookieDomainException | selenium.common.exceptions.WebDriverException | 当试图在不同的 domain 添加 cookie 时抛出该异常。 |
| 5 | selenium.common.exceptions.InvalidSelectorException | selenium.common.exceptions.NoSuchElementException | 当选择器未返回任何 web 元素时抛出该异常。 |
| 6 | selenium.common.exceptions.InvalidSwitchToTargetException | selenium.common.exceptions.WebDriverException | 当尝试切换到不存在的窗口或框架时抛出该异常。 |
| 7 | selenium.common.exceptions.MoveTargetOutOfBoundsException | selenium.common.exceptions.WebDriverException | 当提供给 ActionChains 的可移动目标无效（如超出文件范围）时抛出该异常。 |
| 8 | selenium.common.exceptions.NoSuchWindowException | selenium.common.exceptions.InvalidSwitchToTargetException | 当尝试切换到一个不存在的窗口时抛出该异常。 |
| 9 | selenium.common.exceptions.RemoteDriverServerException | selenium.common.exceptions.WebDriverException | 当远程 WebDriver 服务器出现错误时抛出该异常。 |
| 10 | selenium.common.exceptions.UnableToSetCookieException | selenium.common.exceptions.WebDriverException | 当驱动程序无法设置 cookie 时抛出该异常。 |
| 11 | selenium.common.exceptions.UnexpectedAlertPresentException | selenium.common.exceptions.WebDriverException | 当意外的警告弹窗出现时抛出该异常。 |
| 12 | selenium.common.exceptions.UnexpectedTagNameException | selenium.common.exceptions.WebDriverException | 当辅助类没有获取到预期的 web 元素时抛出该异常。 |
结语
掌握 Selenium 中的异常类及其处理方法，可以大大提高自动化测试脚本的健壮性和稳定性。希望本文能帮助你更好地理解和应对 Selenium 中的各种异常情况，从而编写出更高质量的测试代码。