Selenium 之 WebDriverWait

客官°小女子只卖身不卖艺 2022-03-17 01:44 195阅读 0赞

之前有篇文章介绍过Selenium的等待知识，可惜当时水平有限，只介绍了sleep和implicitly\_wait的用法。今天还是补充一下WebDriverWait的知识吧。

一、webdrivewait 示例代码

1.  `from selenium import webdriver`
2.  `from selenium.webdriver.support.ui import WebDriverWait`
3.  `from selenium.webdriver.support import expected_conditions as EC`
4.  `from selenium.webdriver.common.by import By`
5.  `import time`
6.   
7.  `driver = webdriver.Chrome()`
8.  `driver.get("http://www.baidu.com/")`
9.  `locator = (By.ID,"kw")`
10.  
11. `try:`
12. `ele = WebDriverWait(driver,10).until(EC.presence_of_element_located(locator))`
13. `driver.find_element_by_id("kw").send_keys('abc')`
14. `time.sleep(1) #为了看效果`
15. `except:`
16. `print("ele can't find")`
17. `finally:`
18. `driver.quit()`

接下来一点点分析下这个语句

WebDriverWait(driver,10).until(EC.presence_of_element_located(locator))

（1）WebDriverWait 方法

![SouthEast][]

1.  `driver: 传入WebDriver实例，即我们上例中的driver`
2.  `timeout: 超时时间，等待的最长时间（同时要考虑隐性等待时间）`
3.  `poll_frequency: 调用until或until_not中的方法的间隔时间，默认是0.5秒`
4.  `ignored_exceptions: 忽略的异常，如果在调用until或until_not的过程中抛出这个元组中的异常，`
5.  `则不中断代码，继续等待，如果抛出的是这个元组外的异常，则中断代码，抛出异常。默认只有NoSuchElementException。`

（2）WebDriverWait 方法后面有两种等待方式

![SouthEast 1][]

until

1.  `method: 在等待期间，每隔一段时间（__init__中的poll_frequency）调用这个传入的方法，直到返回值不是False`
2.  `message: 如果超时，抛出TimeoutException，将message传入异常`

until\_not

1.  `与until相反，until是当某元素出现或什么条件成立则继续执行，`
2.  `until_not是当某元素消失或什么条件不成立则继续执行，参数也相同，不再赘述。`

看了以上内容基本上很清楚了，调用方法如下：

WebDriverWait(driver, 超时时长, 调用频率, 忽略异常).until(可执行方法, 超时时返回的信息)

*  1

这里需要特别注意的是until或until\_not中的可执行方法method参数，很多人传入了WebElement对象，如下：

WebDriverWait(driver, 10).until(driver.find_element_by_id('kw'))  # 错误

*  1

这是错误的用法，这里的参数一定要是可以调用的，即这个对象一定有 `__call__()` 方法，否则会抛出异常：

TypeError: 'xxx' object is not callable

*  1

在这里，你可以用selenium提供的 `expected_conditions` 模块中的各种条件，也可以用WebElement的 **`is_displayed()` 、`is_enabled()`、`is_selected()` **方法，或者用自己封装的方法都可以，那么接下来我们看一下selenium提供的条件有哪些：

## **expected\_conditions** ##

**![SouthEast 2][]**

**![SouthEast 3][]**

expected\_conditions是selenium的一个模块，其中包含一系列可用于判断的条件：

selenium.webdriver.support.expected_conditions（模块）

*  1
 *  2

以下两个条件类验证title，验证传入的参数title是否等于或包含于driver.title   
**title\_is   
title\_contains**

以下两个条件验证元素是否出现，传入的参数都是元组类型的locator，如(By.ID, ‘kw’)   
顾名思义，一个只要一个符合条件的元素加载出来就通过；另一个必须所有符合条件的元素都加载出来才行   
**presence\_of\_element\_located   
presence\_of\_all\_elements\_located**

以下三个条件验证元素是否可见，前两个传入参数是元组类型的locator，第三个传入WebElement   
第一个和第三个其实质是一样的   
**visibility\_of\_element\_located   
invisibility\_of\_element\_located   
visibility\_of**

以下两个条件判断某段文本是否出现在某元素中，一个判断元素的text，一个判断元素的value   
**text\_to\_be\_present\_in\_element   
text\_to\_be\_present\_in\_element\_value**

以下条件判断frame是否可切入，可传入locator元组或者直接传入定位方式：id、name、index或WebElement   
**frame\_to\_be\_available\_and\_switch\_to\_it**

以下条件判断是否有alert出现   
**alert\_is\_present**

以下条件判断元素是否可点击，传入locator   
**element\_to\_be\_clickable**

以下四个条件判断元素是否被选中，第一个条件传入WebElement对象，第二个传入locator元组   
第三个传入WebElement对象以及状态，相等返回True，否则返回False   
第四个传入locator以及状态，相等返回True，否则返回False   
**element\_to\_be\_selected   
element\_located\_to\_be\_selected   
element\_selection\_state\_to\_be   
element\_located\_selection\_state\_to\_be**

最后一个条件判断一个元素是否仍在DOM中，传入WebElement对象，可以判断页面是否刷新了   
**staleness\_of**

上面是所有17个condition，与until、until\_not组合能够实现很多判断，如果能自己灵活封装，将会大大提高脚本的稳定性。

封装示例：

待补充

[SouthEast]: /images/20220317/5e99c3bc7b4e4f4eaaca9b235e91509a.png
[SouthEast 1]: /images/20220317/aaef52a4359841faa27ae46e6671c34e.png
[SouthEast 2]: /images/20220317/e147c3f6c71c4814a1513b1d84fb011f.png
[SouthEast 3]: /images/20220317/de2e725714bd4459bf1c3b1721143dbf.png