Selenium 异常类详解

在使用 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 中的各种异常情况，从而编写出更高质量的测试代码。