异常处理 Selenium Webdriver(类型)

⚡ 智能摘要

异常处理 Selenium WebDriver 会阻止失败的命令停止执行。ping 一次完整的测试运行。 Java try-catch、多个 catch 块、throw、throws,最后,它们都为脚本提供了一种不同的恢复方式。

  • 🔘 定义: 异常是指程序执行过程中引发的错误,未处理的异常会导致程序崩溃。
  • ☑️ 范围: Selenium WebDriver 提供了超过 40 个异常类,而每一个异常类都继承自 WebDriverException。
  • ✅ 惯犯: NoSuchElementException、TimeoutException、StaleElementReferenceException 和 ElementNotInteractableException 是造成大多数实际故障的原因。
  • 🧪 处理: try-catch 对隔离一种错误类型,多个 catch 块分隔多种错误类型,最后始终执行。
  • 🛠️ 升级: throw 和 throws 关键字会在当前方法无法解决异常时将异常传递回调用者。
  • 📊 诊断: printStackTrace()、toString() 和 getMessage() 分别报告不同级别的故障详情。

异常处理 Selenium WebDriver 带有 try-catch、throw 和 finally 语句

什么是异常?

异常是指程序执行过程中发生的错误。程序运行时,编程语言会生成一个必须处理的异常,否则程序会崩溃。

该异常表明,虽然此类事件可能发生,但发生频率很低。当方法无法处理该异常时,它会被抛给调用它的函数。 Java这驱动了大多数 Selenium 套件中,每个 WebDriver 异常都是未经检查的,因此编译器永远不会强制您捕获它——未处理的故障只会在运行时出现。

异常类型 Selenium 网络驱动程序

WebDriverException 是异常层次结构的基类,其下层所有异常都继承自它。下表列出了您可能遇到的所有 41 种异常,以及引发每种异常的条件。

# 特殊课程 当它发生时
1 元素不可见异常 DOM 中已存在的元素具有隐藏的功能集。
2 ElementNotSelectableException 该元素已存在于 DOM 中,但无法选中,因此无法进行交互。
3 没有这样的元素异常 无法使用以下方法找到该元素: 定位器 提供。
4 NoSuchFrameException 此 框架 要切换到的目标不存在。
5 不存在警报异常 切换到 警报 即使没有显示任何警报,也会运行。
6 不存在此类窗口异常 要切换到的窗口目标不存在。
7 过时元素引用异常 该网页元素已从当前页面分离。 DOM.
8 SessionNotFoundException WebDriver 会在您关闭浏览器后继续运行。
9 超时异常 命令未能及时完成——例如,在等待时间内未找到要查找的元素。
10 WebDriverException 其他 WebDriver 异常的基类;当 WebDriver 在浏览器关闭后立即执行操作时也会引发此异常。
11 ConnectionClosedException 驱动程序出现故障。
12 ElementClickInterceptedException 接收事件的元素会隐藏点击请求的元素。
13 ElementNotInteractableException 该元素存在于 DOM 中,但无法与其交互。
14 ErrorInResponseException 与……交互时出现故障 Firefox 扩展或远程驱动程序服务器。
15 ErrorHandler.UnknownServerException 当服务器返回错误但未提供堆栈信息时,此字段用作占位符。 trace.
16 IME激活失败异常 输入法引擎激活失败。
17 IMENOTAVAILABLE异常 不支持输入法编辑器。
18 不安全证书异常 导航导致用户代理遇到问题 证书警告无效或过期的 TLS 证书会导致这种情况。
19 无效参数异常 参数类型与预期不符。
20 无效Cookie域异常 A Cookie 是在不同的域下添加的,而不是在当前域下添加的。 URL.
21 无效坐标异常 匹配的交互操作无效。
22 无效元素状态异常 由于元素无效,命令无法完成。
23 无效会话 ID 异常 给定的会话 ID 不在活动会话中,因此该会话不存在或处于非活动状态。
24 无效的开关Target特殊课程 要切换到的框架或窗口目标不存在。
25 Javascript特殊课程 执行过程中出现错误 Java用户提供的脚本。
26 JsonException 当会话尚未创建时,系统会请求会话。
27 NoSuchAttributeException 找不到元素的属性。
28 移动Target越界异常 提供给 ActionChains move() 方法的目标无效——例如,超出文档范围。
29 NoSuchContextException ContextAware 进行移动设备测试时,找不到请求的上下文。
30 NoSuchCookieException 在当前浏览文档的 cookie 中,未找到与给定路径名称匹配的 cookie。
31 NotFoundException WebDriverException 的子类,当 DOM 中的元素不存在时引发。
32 远程驱动程序服务器异常 服务器没有响应,因为所描述的功能不正确。
33 ScreenshotException 无法捕获屏幕。
34 SessionNotCreatedException 创建新会话失败。
35 无法设置 Cookie 异常 驱动程序无法设置 cookie。
36 意外的标签名异常 支持类没有按预期获取到网页元素。
37 未处理的警报异常 虽然有警报,但 WebDriver 无法执行警报操作。
38 意外警报出现异常 出现意外警报。
39 未知方法异常 请求的命令与已知命令匹配。 URL 但并非针对这种情况的具体方法。 URL.
40 无法访问的浏览器异常 浏览器无法打开,或者由于某种原因崩溃了。
41 不支持的命令异常 远程 WebDriver 未按预期发送有效命令。

日常调试主要涉及三件事:NoSuchElementException 表示错误 XPath的 或者对于尚未渲染的元素,TimeoutException 表示等待时间过短。 AJAX的 响应之后是 StaleElementReferenceException 异常 动态 重新渲染。

如何处理异常 Selenium

以下是处理异常的标准构造 Selenium WebDriver。每个都是普通的 Java所以它在任何情况下都有效。 WebDriver脚本 无需额外库。

步骤 1)Try-catch

这种方法可以使用 try 和 catch 关键字的组合来捕获异常。try 命令标记代码块的开始,而 catch 则放在 try 代码块的末尾,用于处理异常。

try
{
// Code
} catch (Exception e) {
// Code for Handling exception
}

步骤 2)多个 catch 块

异常类型有很多种,一段代码块可以引发多种异常。多个 catch 块允许你使用各自的代码分别处理每种异常。你可以使用两个以上的 catch 块,添加的数量没有限制。

try
{
//Code
} catch (ExceptionType1 e1) {
//Code for Handling Exception 1
} catch (ExceptionType2 e2) {
//Code for Handling Exception 2
}

步骤 3)抛出

当你想抛出一个异常时,`throw` 关键字会将异常传递给运行时进行处理。当你需要将异常传递下去而不是在当前方法中解决它时,请使用 `throw`。

public static void anyFunction() throws Exception{

try {
// write your code here
} catch (Exception b) {
// Do whatever you want to perform 
// Throw the Exception back to the system
throw(b);
}
}

步骤 4)多个例外

你可以在 throws 子句中提及各种异常情况。

public static void anyFunction() throws ExceptionType1, ExceptionType2{

try {
// write your code here
} catch (ExceptionType1 e1) {
// Code to handle exception 1
} catch (ExceptionType2 e2) {
// Code to handle exception 2
}

步骤 5)最后

finally 关键字会在 try 代码块下方创建一个代码块。无论是否发生异常,它都会执行,因此是关闭驱动程序或释放文件句柄的合适位置。

try {
//Code
} catch (ExceptionType1 e1) {
//Catch block
} catch (ExceptionType2 e2) {
//Catch block
} catch (ExceptionType3 e3) {
//Catch block
} finally {
//The finally block always executes.
}

显示异常信息的方法

一旦捕获到异常,对象本身就会包含诊断详情。您可以使用以下方法显示它:

付款方式 它报道了什么
printStackTrace () 打印堆栈信息 trace,异常名称和其他有用的描述。
toString() 返回一条描述异常名称和描述的文本消息。
getMessage() 单独显示异常描述。

将这些截图与 catch 代码块内的截图结合起来,失败的运行结果既显示了哪里出了问题,也显示了页面显示的内容。

常见问题

所有 WebDriver 异常都是未经检查的,因为它们都通过 WebDriverException 继承自 RuntimeException。因此,编译器永远不会要求使用 try-catch 语句,这很方便,但也意味着只有在实际运行测试时才会出现未加保护的定位器故障。

在对元素执行操作之前立即重新定位它,而不是缓存其引用。一个忽略异常并重新获取节点的短重试循环,比长时间的休眠更能可靠地处理 React 或 Vue 的重新渲染。

它们大幅减少了等待时间,但从未完全消除。显式等待只能解决时序问题——错误的定位器、被拦截的点击或已关闭的会话仍然会引发异常,而只有 catch 代码块才能捕获这些异常。

Selenium 4 版本保持了相同的层次结构,但 wait 构造函数现在接受 Duration 参数而不是整数超时时间,更严格的 W3C 参数验证意味着对于某些值会抛出 InvalidArgumentException 异常。 Selenium 3人无异议接受。

自愈式定位引擎 track 会破坏选择器并替换为可用的替代方案,从而消除大部分 NoSuchElementException 失败。类似的模型会对重复的堆栈进行聚类。 trac这样一来,真正的新缺陷就不会被埋没在不稳定的重复运行中。

Copilot 的优势在于样板代码——它包含 try-catch 框架、顺序正确的 catch 链以及用于退出驱动程序的 finally 代码块。但它无法得知你的应用程序会抛出哪些异常,因此你需要检查每个生成的 catch 块。

它们相辅相成。ITestListener 集中记录所有失败测试的日志和屏幕截图,从而保持测试代码的简洁。只有当脚本必须在错误发生后继续执行,而不仅仅是报告错误时,才应该使用 try-catch 语句。

在 catch 或 finally 代码块中将驱动程序强制转换为 TakesScreenshot 类型,并在会话关闭前写入文件。将镜像文件命名为测试方法名称,可以确保即使无需在本地重现故障,也能读取失败的 CI 运行结果。

总结一下这篇文章: