Selenium WebDriver - 其它

一、上手

如果您是Selenium的新手，我们有一些资源可以帮助您立即了解最新情况。

Selenium通过使用WebDriver支持市场上所有主要浏览器的自动化。

WebDriver是一种API和协议，它定义了一个语言中立的界面，用于控制Web浏览器的行为。

每个浏览器都有一个特定的WebDriver实现，称为驱动程序。

驱动程序是负责委托给浏览器的组件，并处理Selenium和浏览器之间的通信。

这种分离是有意识地让浏览器供应商对其浏览器的实现负责的努力的一部分。

Selenium尽可能使用这些第三方驱动程序，但也为不现实的情况提供由项目维护的自己的驱动程序。

Selenium框架通过一个面向用户的界面将所有这些部分联系在一起，使不同的浏览器后端能够透明地使用，从而实现跨浏览器和跨平台自动化。

Selenium设置与其他商业工具的设置完全不同。

在开始编写Selenium代码之前，您必须为您选择的语言安装语言绑定库、您要使用的浏览器以及该浏览器的驱动程序。

按照下面的链接开始使用Selenium WebDriver。

如果您希望从低代码/录制和播放工具开始，请检查 Selenium IDE

一旦你把事情做好，如果你想扩大你的测试，看看 Selenium 网格。

二、Driver Sessions

启动和停止会话用于打开和关闭浏览器。

创建会话

创建一个新会话对应于W3C命令的新建会话

会话是通过初始化一个新的Driver类对象自动创建的。

每种语言都允许使用来自以下类之一（或等效类）的参数创建会话：

选项来描述您想要的会话类型；默认值用于本地，但这是远程所必需的
某种形式的HTTP客户端配置（实现因语言而异）
听众

本地驱动

启动本地驱动程序的主要唯一参数包括有关在本地计算机上启动所需驱动程序服务的信息。

服务对象仅适用于本地驱动程序并提供有关浏览器驱动程序的信息

三、支持的浏览器

每个浏览器都具有自定义功能和独特的功能。

Chrome特定功能

这些是特定于GoogleChrome浏览器的功能和特性。

Edge 特定功能

这些是特定于Microsoft Edge浏览器的功能和特性。

Firefox特定功能

这些是特定于Mozilla Firefox浏览器的功能和特性。

IE特定功能

这些是特定于Microsoft Internet Explorer浏览器的功能和特性。

Safari特定功能

这些是苹果Safari浏览器特有的功能和特性。

四、等待策略

也许浏览器自动化最常见的挑战是确保Web应用程序处于按需执行特定Selenium命令的状态。

这些进程通常以竞争条件告终，有时浏览器首先进入正确的状态（事情按预期工作），有时Selenium代码首先执行（事情按预期工作）。

这是不稳定测试的主要原因之一。

所有导航命令等待特定的readyState值基于页面加载策略（the 在驱动程序将控制权返回给代码之前，要等待的默认值是"complete"）。

readyState关心加载超文本标记语言定义的资产，但加载的JavaScript资产通常会导致网站发生变化，并且需要交互的元素可能还没有出现在页面上当代码准备好执行下一个Selenium命令时。

类似地，在许多单页应用程序中，元素是动态获取的添加到页面或根据单击更改可见性。

一个元素必须同时存在和显示在页面上为了让Selenium 与之互动。

以这个页面为例：https://www.selenium.dev/selenium/web/dynamic.html

单击"添加框！"按钮时，会创建一个不存在的"div"元素。

单击"显示新输入"按钮时，会显示一个隐藏的文本字段元素。

在这两种情况下，转换都需要几秒钟。

如果Selenium代码要单击其中一个按钮并与生成的元素交互，它将在该元素准备好并失败之前执行此操作。

许多人转向的第一个解决方案是添加一个睡眠语句来暂停代码执行一段时间。

因为代码不能确切知道它需要等待多长时间，所以当它睡眠时间不够长时，这可能会失败。

或者，如果该值设置得太高，并且在需要的每个地方都添加了一个睡眠语句，会话的持续时间可能会变得令人望而却步。

Selenium提供了两种更好的同步机制。

隐式等待

Selenium有一种自动等待元素的内置方法，称为隐式等待 。

隐式等待值可以设置为超时浏览器选项中的功能，或使用驱动程序方法（如下所示）。

这是一个全局设置，适用于整个会话的每个元素位置调用。

默认值为0，这意味着如果没有找到该元素，它将立即返回错误。

如果设置了隐式等待，驱动程序将等待返回错误之前提供值的持续时间。

请注意，一旦元素定位，驱动程序将返回元素引用，代码将继续执行，因此，较大的隐式等待值不一定会增加会话的持续时间。

警告：不要混合隐式和显式等待。

这样做可能会导致不可预测的等待时间。

例如，设置隐式等待10秒和显式等待15秒可能会导致20秒后超时。

使用隐式等待解决我们的示例如下所示：

py 复制代码

driver.implicitly_wait(2)

在GitHub上查看完整示例

显式等待

显式等待是添加到代码中的循环，它轮询应用程序以获取特定条件，以便在退出循环并继续执行代码中的下一个命令之前评估为true。

如果在指定的超时值之前没有满足条件，则代码将给出超时错误。

由于有许多方法可以让应用程序不处于所需的状态，因此显式等待是在每个需要它的地方指定要等待的确切条件的绝佳选择。

另一个不错的功能是，默认情况下，Selenium等待类会自动等待指定元素的存在。

此示例将等待的条件显示为lambda 。

Python还支持预期条件

py 复制代码

wait = WebDriverWait(driver, timeout=2)
wait.until(lambda d : revealed.is_displayed())

在GitHub上查看完整示例

定制化

等待类可以使用各种参数来实例化，这些参数将改变评估条件的方式。

这可以包括：

更改评估代码的频率（轮询间隔）
指定应自动处理哪些异常
更改总超时长度
自定义超时消息

例如，如果元素not interactable 错误默认重试，那么我们可以在执行的代码中添加对方法的操作（我们只需要确保代码成功时返回true）：

py 复制代码

errors = [NoSuchElementException, ElementNotInteractableException]
wait = WebDriverWait(driver, timeout=2, poll_frequency=.2, ignored_exceptions=errors)
wait.until(lambda d : revealed.send_keys("Displayed") or True)

在GitHub上查看完整示例

五、双向功能

Selenium正在与浏览器供应商合作创建 WebDriver双向协议作为提供使用双向的稳定、跨浏览器API的一种手段对浏览器自动化和测试都有用的功能。

在此之前，寻求此功能的用户必须依赖CDP（ChromeDevTools协议）所有的挫折和限制。

严格请求/响应命令的传统WebDriver模型将通过WebSockets将事件从用户代理流式传输到控制软件的能力进行补充，更好地匹配浏览器DOM的事件性质。

由于将测试绑定到任何浏览器的特定版本都不是一个好主意，Selenium项目建议尽可能使用WebDriver BiDi。

在规范制定过程中，浏览器供应商正在并行实施该WebDriver双向协议。

请参阅web平台测试仪表板看看浏览器供应商的进展情况。

Selenium正在努力跟上浏览器供应商的步伐，并已开始实施W3C BiDi API。

目标是确保API符合W3C并在不同的语言绑定之间保持统一。

但是，在规范和相应的Selenium实现完成之前，CDP提供了许多有用的东西。

Selenium提供了一些使用CDP的有用帮助类。

1、Chrome开发工具

许多浏览器都提供"开发工具"------一组与浏览器集成的工具，开发人员可以使用这些工具来调试网络应用程序并探索其页面的性能。

谷歌浏览器的开发工具使用了一种称为Chrome开发工具协议（简称"CDP"）的协议。

顾名思义，这不是为测试而设计的，也不是为了有一个稳定的应用编程接口，所以功能高度依赖于浏览器的版本。

该WebDriver双向协议是下一代的 W3C WebDriver协议，旨在提供所有浏览器实现的稳定API，但尚未完成。

在此之前，Selenium提供访问实现它的浏览器（如谷歌Chrome或Microsoft Edge的CDP Firefox），允许您以有趣的方式增强测试。

您可以做的一些示例用它做下面给出。

使用SeleniumChrome开发工具的方法

有三种不同的方法可以访问SeleniumChrome开发工具。

如果你在网上寻找其他例子，你可能会看到这些混合和匹配。

用户的第一个选择是CDP端点。
它只适用于最简单的事情（设置状态，获取基本信息），而您必须知道域、方法和键值对的"魔术字符串"。
对于基本需求，这可能比其他选项更简单。
这些方法只是暂时支持的。
与仅使用端点相比，CDP API是一种改进，因为您可以设置异步做事。
您可以访问支持的类，而不是字符串和映射，代码中的方法和参数。
这些方法也只是暂时支持的。
应该尽可能使用BiDi API选项，因为它完全抽象出实现细节，并将与CDP或WebDriver-BiDi一起使用当Selenium 离开CDP时。

价值有限的示例

有许多常用的使用CDP的例子，它们的实用价值有限。

地理位置-几乎所有站点都使用IP地址来确定物理位置，因此设置模拟地理位置很少能达到预期的效果。
覆盖设备指标 -Chrome提供了一个很棒的API来设置移动仿真在Options类中，这通常优于尝试使用CDP执行此操作。

查看这些文档中的示例，了解做其他有用事情的方法：

ChromeDevTools协议端点
Google提供了一个可以直接访问的/cdp/execute端点，每个Selenium绑定都提供了一个方法，允许您将CDP域作为字符串传递，并将所需参数作为简单的Map传递。
Chrome开发工具协议API
每个Selenium绑定都会为各种CDP域和特性动态生成类和方法；这些绑定与Chrome的特定版本相关联。
Chrome开发者工具协议
这些示例目前使用CDP实现，但当使用WebDriver-BiDi重新实现该功能时，相同的代码应该可以工作。

ChromeDevTools协议端点

Google提供了一个可以直接访问的/cdp/execute端点，每个Selenium绑定都提供了一个方法，允许您将CDP域作为字符串传递，并将所需参数作为简单的Map传递。

这些方法最终会被删除。

建议使用WebDriver-BiDi或WebDriver Bidi API 尽可能确保未来兼容性的方法。

用法

一般来说，您应该更喜欢使用CDP API而不是这种方法，但有时语法更简洁或更简单。

限制包括：

它仅适用于仅限于设置或获取信息的用例；任何实际的异步交互都需要另一个实现
您必须知道域和密钥的完全正确的"魔法字符串"
对Chrome的更新可能会更改所需的参数

例子

设置Cookie

另一种实现可以在CDP API Set Cookie

py 复制代码

    cookie = {'name': 'cheese',
              'value': 'gouda',
              'domain': 'www.selenium.dev',
              'secure': True}

    driver.execute_cdp_cmd('Network.setCookie', cookie)

在GitHub上查看完整示例

绩效指标

另一种实现可以在CDP API性能指标

py 复制代码

    driver.execute_cdp_cmd('Performance.enable', {})

    metric_list = driver.execute_cdp_cmd('Performance.getMetrics', {})["metrics"]

在GitHub上查看完整示例

基本认证

替代实现可以在CDP API基本身份验证和BiDi API基本认证

py 复制代码

    driver.execute_cdp_cmd("Network.enable", {})

    credentials = base64.b64encode("admin:admin".encode()).decode()
    headers = {'headers': {'authorization': 'Basic ' + credentials}}

    driver.execute_cdp_cmd('Network.setExtraHTTPHeaders', headers)

在GitHub上查看完整示例

Chrome开发工具协议API

每个Selenium绑定都会为各种CDP域和特性动态生成类和方法；这些绑定与Chrome的特定版本相关联。

虽然Selenium 4提供对Chrome开发工具协议（CDP）的直接访问，但这些方法最终会被删除。

建议使用WebDriver Bidi API 尽可能确保未来兼容性的方法。

用法

如果您的用例已由WebDriver Bidi或对于BiDi API，您应该使用这些实现而不是这个。

通常，您应该更喜欢这种方法，而不是使用CDP端点执行，尤其是在Ruby中。

例子

设置Cookie

另一种实现可以在CDP端点设置Cookie

因为Python需要在此示例中使用异步方法，所以在 CDP端点集Cookie可能更容易。

py 复制代码

async with driver.bidi_connection() as connection:
     execution = connection.devtools.network.set_cookie(
         name="cheese",
         value="gouda",
         domain="www.selenium.dev",
         secure=True
     )

     await connection.session.execute(execution)

在GitHub上查看完整示例

绩效指标

可以在CDP端点性能指标中找到替代实现

因为Python需要在此示例中使用异步方法，所以在 CDP端点性能指标可能更容易。

py 复制代码

async with driver.bidi_connection() as connection:
     await connection.session.execute(connection.devtools.performance.enable())

     metric_list = await connection.session.execute(connection.devtools.performance.get_metrics())

在GitHub上查看完整示例

基本认证

可以在以下位置找到替代实现 CDP端点基本认证和BiDi API基本认证

因为Python需要在此示例中使用异步方法，所以在 CDP端点基本身份验证可能更容易。

py 复制代码

async with driver.bidi_connection() as connection:
    await connection.session.execute(connection.devtools.network.enable())

    credentials = base64.b64encode("admin:admin".encode()).decode()
    auth = {'authorization': 'Basic ' + credentials}

    await connection.session.execute(connection.devtools.network.set_extra_http_headers(Headers(auth)))

在GitHub上查看完整示例

控制台日志

因为读取控制台日志需要设置事件侦听器，这不能通过CDP端点实现来完成可以在以下位置找到替代实现 BiDi API控制台日志和错误和WebDriver BiDi控制台日志

使用BiDi API控制台日志和错误实现

添加示例

JavaScript异常

类似于控制台日志，但这会侦听实际的javascript异常，而不仅仅是记录的错误可以在以下位置找到替代实现 BiDi API JavaScript异常和WebDriver BiDi JavaScript异常

使用BiDi API JavaScript异常实现

添加示例

下载完成

在继续之前等待下载完成。

因为获取下载状态需要设置侦听器，所以这不能通过CDP端点实现来完成。

添加示例

Chrome开发者工具协议

这些示例目前使用CDP实现，但当使用WebDriver-BiDi重新实现该功能时，相同的代码应该可以工作。

用法

以下API列表将随着Selenium的增长而增长项目通过支持现实世界的用例来工作。

如果有是您想看到的附加功能，请提出功能要求。

由于这些示例使用WebDriver-Bidi协议重新实现，它们将移动到WebDriver Bidi页面。

例子

基本认证

一些应用程序使用浏览器身份验证来保护页面。

过去在URL中处理它们很常见，但浏览器不再支持此功能。

使用BiDi，您现在可以在必要时提供凭据

可以在以下位置找到替代实现 CDP端点基本认证和CDP API基本认证

可以在以下位置找到替代实现 CDP端点基本认证

引脚脚本

这在远程服务器上执行时特别有用。

例如，每当您检查元素的可见性时，或者每当您使用经典的get属性方法时，Selenium正在将js文件的内容发送到脚本执行端点。

这些文件每个大约50kB，加起来。

突变观察

突变观察是当DOM中的特定元素发生DOM突变时通过WebDriver BiDi捕获事件的能力。

py 复制代码

async with driver.bidi_connection() as session:
    log = Log(driver, session)

在GitHub上查看完整示例

控制台日志和错误

监听console.log事件并注册回调以处理该事件。

CDP API控制台日志和WebDriver BiDi控制台日志

py 复制代码

async with driver.bidi_connection() as session:
     log = Log(driver, session)

     async with log.add_listener(Console.ALL) as messages:

在GitHub上查看完整示例

JavaScript异常

监听JS异常并注册回调以处理异常详细信息。

py 复制代码

async with driver.bidi_connection() as session:
    log = Log(driver, session)

    async with log.add_js_error_listener() as messages:

在GitHub上查看完整示例

网络拦截

请求和响应都可以被记录或转换。

响应信息

响应变换

请求拦截

2、双向API（符合W3C）

以下API列表将随着WebDriver双向协议的增长而增长和浏览器供应商实现相同。

此外，Selenium将尝试支持内部使用W3C BiDi协议API组合的实际用例。

如果您想看到其他功能，请提出功能要求。

六、支持功能

支持类提供可选的更高级别的功能。

Selenium的核心库试图成为低级和非固执己见的。

每种语言中的支持类都为常见的交互提供了固执己见的包装器，可用于简化某些行为。

1、以预期条件等待

这些是用来描述需要等待什么的类。

预期条件与显式等待一起使用。

不是定义要使用lambda 执行的代码块，而是预期的可以创建条件方法来表示等待的常见事物。

一些方法将定位器作为参数，其他方法将元素作为参数。

这些方法可以包括以下条件：

元素存在
元素陈旧
元素可见
文本可见
标题包含指定值

预期条件文档

添加示例

2、命令侦听器

这些允许您在每次发送特定Selenium命令时执行自定义操作

添加示例

3、使用颜色

作为测试的一部分，你偶尔会想验证一些东西的颜色；问题是网络上的颜色定义不是恒定的。

如果有一种简单的方法来比较一种颜色的十六进制表示和一种颜色的RGB表示，或者一种颜色的RGBA表示和一种颜色的HSLA表示，那不是很好吗？

别担心。

有一个解决方案：颜色类！

首先，您需要导入类：

python 复制代码

from selenium.webdriver.support.color import Color

您现在可以开始创建颜色对象。

每个颜色对象都需要从您的颜色的字符串表示中创建。

支持的颜色表示是：

python 复制代码

HEX_COLOUR = Color.from_string('#2F7ED8')
RGB_COLOUR = Color.from_string('rgb(255, 255, 255)')
RGB_COLOUR = Color.from_string('rgb(40%, 20%, 40%)')
RGBA_COLOUR = Color.from_string('rgba(255, 255, 255, 0.5)')
RGBA_COLOUR = Color.from_string('rgba(40%, 20%, 40%, 0.5)')
HSL_COLOUR = Color.from_string('hsl(100, 0%, 50%)')
HSLA_COLOUR = Color.from_string('hsla(100, 0%, 50%, 0.5)')

Color类还支持所有基本颜色定义指定于 http://www.w3.org/TR/css3-color/#html4.

python 复制代码

BLACK = Color.from_string('black')
CHOCOLATE = Color.from_string('chocolate')
HOTPINK = Color.from_string('hotpink')

有时，如果元素上没有设置颜色，浏览器会返回"透明"的颜色值。

Color类也支持这一点：

python 复制代码

TRANSPARENT = Color.from_string('transparent')

您现在可以安全地查询元素以获取其颜色/背景颜色，因为您知道任何响应都将被正确解析并转换为有效的Color对象：

python 复制代码

login_button_colour = Color.from_string(driver.find_element(By.ID,'login').value_of_css_property('color'))

login_button_background_colour = Color.from_string(driver.find_element(By.ID,'login').value_of_css_property('background-color'))

然后，您可以直接比较颜色对象：

python 复制代码

assert login_button_background_colour == HOTPINK

或者，您可以将颜色转换为以下格式之一并执行静态验证：

python 复制代码

assert login_button_background_colour.hex == '#ff69b4'
assert login_button_background_colour.rgba == 'rgba(255, 105, 180, 1)'
assert login_button_background_colour.rgb == 'rgb(255, 105, 180)'

颜色不再是问题。

4、使用选择列表元素

与其他元素相比，选择列表具有特殊的行为。

Select对象现在将为您提供一系列命令允许您与<select>元素交互。

如果您使用Java或. NET，请确保您在代码中正确需要支持包。

请参阅下面任何示例中来自GitHub的完整代码。

请注意，此类仅适用于超文本标记语言元素select和option。

可以使用div或li设计带有JavaScript覆盖的下拉列表，这个类不适用于那些。

类型

Select方法的行为可能会有所不同，具体取决于正在使用的<select>元素的类型。

单选

这是标准的下拉对象，其中可以选择一个且只能选择一个选项。

html 复制代码

<select name="selectomatic">
    <option selected="selected" id="non_multi_option" value="one">One</option>
    <option value="two">Two</option>
    <option value="four">Four</option>
    <option value="still learning how to count, apparently">Still learning how to count, apparently</option>
</select>

多选

此选择列表允许一次选择和取消选择多个选项。

这仅适用于具有multiple属性的<select>元素。

html 复制代码

<select name="multi" id="multi" multiple="multiple">
    <option selected="selected" value="eggs">Eggs</option>
    <option value="ham">Ham</option>
    <option selected="selected" value="sausages">Sausages</option>
    <option value="onion gravy">Onion gravy</option>
</select>

创建类

首先定位一个<select>元素，然后使用它来初始化一个Select对象。

请注意，从Selenium 4.5开始，如果禁用<select>元素，则无法创建Select对象。

py 复制代码

select_element = driver.find_element(By.NAME, 'selectomatic')
select = Select(select_element)

在GitHub上查看完整示例

列出选项

可以获得两个列表：

所有选项

获取<select>元素中所有选项的列表：

py 复制代码

option_list = select.options

在GitHub上查看完整示例

选定选项

获取<select>元素中选定选项的列表。

对于标准选择列表这将是一个只有一个元素的列表，对于它可以包含的多选列表零个或多个元素。

py 复制代码

selected_option_list = select.all_selected_options

在GitHub上查看完整示例

选择选项

Select类提供了三种选择选项的方法。

请注意，对于多个选择类型选择列表，您可以对要选择的每个元素重复这些方法。

文字

根据其可见文本选择选项

py 复制代码

select.select_by_visible_text('Four')

在GitHub上查看完整示例

价值

根据其值属性选择选项

py 复制代码

select.select_by_value('two')

在GitHub上查看完整示例

索引

根据其在列表中的位置选择选项

py 复制代码

select.select_by_index(3)

在GitHub上查看完整示例

禁用选项

Selenium v4.5

不能选择具有disabled属性的选项。

html 复制代码

<select name="single_disabled">
  <option id="sinlge_disabled_1" value="enabled">Enabled</option>
  <option id="sinlge_disabled_2" value="disabled" disabled="disabled">Disabled</option>
</select>

py 复制代码

with pytest.raises(NotImplementedError):
    select.select_by_value('disabled')

在GitHub上查看完整示例

取消选择选项

只有多个选择类型选择列表可以取消选择选项。

您可以为要选择的每个元素重复这些方法。

py 复制代码

select.deselect_by_value('eggs')

在GitHub上查看完整示例

七、故障排除协助

如何获得管理WebDriver问题。

Selenium 中错误的根本原因并不总是显而易见的。

最常见的Selenium 相关错误是同步不良的结果。
阅读等待策略。
如果你不确定是一种同步策略，你可以尝试暂时硬编码一个大睡眠您在哪里看到问题，您将知道添加显式等待是否有帮助。
请注意，向项目报告的许多错误实际上是由 Selenium向其发送命令的底层驱动程序中的问题。
你可以统治通过在多个浏览器中执行命令解决驱动程序问题。
如果您对如何做事有疑问，请查看支持选项寻求帮助的方式。
如果您认为您发现了Selenium代码的问题，请继续提交错误报告在GitHub上。

了解常见错误

如何处理Selenium代码中的各种问题。

记录Selenium命令

获取有关Selenium执行的信息。

升级到Selenium 4

您还在使用Selenium 3吗？本指南将帮助您升级到最新版本！

1、了解常见错误

如何处理Selenium代码中的各种问题。

无效的选择器异常

CSS和XPath选择器有时很难正确。

可能原因

您尝试使用的CSS或XPath选择器具有无效字符或无效查询。

可能的解决方案

通过验证器服务运行您的选择器：

或者使用浏览器扩展来获得已知的良好价值：

选择器中心

没有这样的元素例外

无法在您尝试定位它的确切时刻找到该元素。

可能原因

您正在错误的位置查找元素（可能之前的操作不成功）。
您在错误的时间查找元素（该元素尚未显示在DOM中）
自您编写代码以来，定位器已更改

可能的解决方案

确保您在您期望的页面上，并且代码中的先前操作正确完成
确保您使用正确的等待策略
使用浏览器的devtools控制台更新定位器或使用浏览器扩展程序，例如：
- 选择器中心

陈旧元素引用异常

一个元素在以前被定位时变得陈旧，但当前无法访问。

元素不会自动重新定位；驱动程序为该元素创建一个引用ID，并在DOM中具有它期望找到它的特定位置。

如果它在当前DOM中找不到该元素，任何使用该元素的操作都将导致此异常。

常见原因

这可能发生在以下情况：

您已刷新页面，或者页面的DOM已动态更改。
您已导航到不同的页面。
您已切换到另一个窗口或进入或退出框架或iframe。

通用解决方案

DOM已更改

当页面刷新或页面上的项目移动时，页面上仍然有一个具有所需定位器的元素，它只是不再被正在使用的元素对象访问，并且必须重新定位该元素才能再次使用。

这通常通过以下两种方式之一完成：

每次使用元素时都要重新定位它。
元素在定位和使用元素之间的微秒内过时的可能性很小，尽管可能。
缺点是这不是最有效的方法，尤其是在远程网格上运行时。
用另一个存储定位器的对象包装Web元素，并缓存已定位的Selenium元素。
使用此包装的对象执行操作时，如果先前已定位，则可以尝试使用缓存的对象，如果它已过时，则可以捕获异常，使用存储的定位器重新定位元素，并重新尝试方法。
这更有效，但如果您使用的定位器在页面更改后引用不同的元素（而不是您想要的元素），则可能会导致问题。

背景已经改变

元素对象是为给定的上下文存储的，所以如果您移动到不同的上下文------比如不同的窗口或不同的框架或iframe------元素引用仍然有效，但暂时无法访问。

在这种情况下，重新定位元素没有帮助，因为它不存在于当前上下文中。

要解决这个问题，您需要确保在使用元素之前切换回正确的上下文。

页面已更改

这种情况是当你不只是改变上下文时，您已经导航到另一个页面，并销毁了元素所在的上下文。

您不能只是将其从当前上下文中重新定位，也不能切换回有效的活动上下文。

如果这是您错误的原因，您必须导航回正确的位置并重新定位它。

无法找到驱动程序错误

对驱动程序可执行文件缺少路径进行故障排除。

2、记录Selenium命令

获取有关Selenium执行的信息。

打开日志记录是获取额外信息的一种有价值的方法，这些信息可能会帮助您确定为什么会出现问题。

找个

Python日志通常是为每个模块创建的。

您可以通过引用顶级模块来匹配所有子模块。

因此，要使用selenium模块中的所有记录器，您可以这样做：

py 复制代码

logger = logging.getLogger('selenium')

在GitHub上查看完整示例

log 级别

记录器级别有助于根据日志的严重性过滤掉日志。

Python有6个日志级别：CRITICAL、ERROR、WARNING、INFO、DEBUG和NOTSET。

默认为WARNING

要更改记录器的级别：

py 复制代码

    logger.setLevel(logging.DEBUG)

在GitHub上查看完整示例

但是，当您使用PyTest时，事情会变得复杂。

默认情况下，除非测试失败，否则PyTest会隐藏日志记录。

您需要设置3件事才能让PyTest在通过测试时显示日志。

要始终使用PyTest输出日志，您需要使用其他参数运行。

首先，-s来防止PyTest捕获控制台。

其次，-p no:logging，它允许您覆盖默认的PyTest日志记录设置，以便日志可以无论错误如何显示。

因此，您需要在IDE中设置这些标志，或者在命令行上运行PyTest，例如：

bash 复制代码

pytest -s -p no:logging

最后，由于您在上面的参数中关闭了日志记录，您现在需要添加配置才能重新打开它：

py 复制代码

logging.basicConfig(level=logging.WARN)

可诉项目

如果事情是用户需要采取行动的，则将其记录为警告。

这通常用于弃用。

由于各种原因，Selenium项目不遵循标准的语义版本控制实践。

我们的政策是在3个版本中将事情标记为弃用，然后将其删除，因此弃用可能会被记录为警告。

Python在记录器级别记录可操作的内容-WARNING 有关弃用的详细信息记录在此级别。

示例：

text 复制代码

WARNING  selenium:test_logging.py:23 this is a warning

有用信息

这是Selenium记录用户应该知道但不需要采取行动的内容的默认级别。

这可能会引用新方法或引导用户了解有关某些内容的更多信息

Python在记录器级别记录有用的信息-INFO

示例：

text 复制代码

INFO     selenium:test_logging.py:22 this is useful information

调试细节

调试日志级别用于诊断问题和排除问题可能需要的信息。

Python日志在日志级别调试细节-DEBUG

示例：

text 复制代码

DEBUG    selenium:test_logging.py:24 this is detailed debug information

log 输出

日志可以显示在控制台中或存储在文件中。

不同的语言有不同的默认值。

默认情况下，所有日志都发送到sys.stderr。

要将输出定向到其他地方，您需要添加一个带有StreamHandler或FileHandler的FileHandler：

py 复制代码

handler = logging.FileHandler(log_path)
logger.addHandler(handler)

在GitHub上查看完整示例

记录器滤波

py 复制代码

logging.getLogger('selenium.webdriver.remote').setLevel(logging.WARN)
logging.getLogger('selenium.webdriver.common').setLevel(logging.DEBUG)

在GitHub上查看完整示例

3、升级到Selenium 4

您还在使用Selenium 3吗？本指南将帮助您升级到最新版本！

如果您使用的是官方支持的语言之一（Ruby、JavaScript、C#、Python和Java），升级到Selenium 4应该是一个轻松的过程。

在某些情况下，可能会出现一些问题，本指南将帮助您解决这些问题。

我们将完成升级项目依赖项的步骤，并了解版本升级带来的主要弃用和更改。

以下是我们将按照以下步骤升级到Selenium 4：

准备我们的测试代码
升级依赖项
潜在错误和弃用消息

注意：在开发Selenium 3. x版本时，实现了对W3C WebDriver标准的支持。

这个新协议和遗留的JSON Wire协议都得到了支持。

在3.11版左右，Selenium代码符合W3C 1级规范。

最新版本Selenium 3中的W3C兼容代码将在Selenium 4中按预期工作。

准备我们的测试代码

Selenium 4删除了对遗留协议的支持，并通过以下方式使用W3C WebDriver标准引擎盖下的默认值。

对于大多数事情，这种实现不会影响最终用户。

主要的例外是Capabilities和Actions类。

能力

如果测试功能的结构不符合W3C，可能会导致无法启动会话。

以下是W3C WebDriver标准功能的列表：

browserName
browserVersion（替换version）
platformName（替换platform）
acceptInsecureCerts
pageLoadStrategy
proxy
timeouts
unhandledPromptBehavior

标准功能的最新列表可在 W3C WebDriver。

上面列表中未包含的任何功能都需要包含供应商前缀。

这适用于浏览器特定功能以及云供应商特定功能。

例如，如果云供应商在测试中使用build和name功能，则需要将它们包装在cloud:options块（请咨询您的云供应商以获取适当的前缀）。

以前

python 复制代码

caps = {}
caps['browserName'] = 'firefox'
caps['platform'] = 'Windows 10'
caps['version'] = '92'
caps['build'] = my_test_build
caps['name'] = my_test_name
driver = webdriver.Remote(cloud_url, desired_capabilities=caps)

之后

python 复制代码

from selenium.webdriver.firefox.options import Options as FirefoxOptions
options = FirefoxOptions()
options.browser_version = '92'
options.platform_name = 'Windows 10'
cloud_options = {}
cloud_options['build'] = my_test_build
cloud_options['name'] = my_test_name
options.set_capability('cloud:options', cloud_options)
driver = webdriver.Remote(cloud_url, options=options)

2024-06-17（一）晴天