应用场景

自动化打开一个网页的时候，内部网页元素加载完全有一点的延迟性，因此在做 Web 端的自动化测试的时候，一般都需要在测试 case 时加入一些等待操作。
我们常用等待操作有 3 种，分别是：强制等待sleep、隐式等待、显示等待

一、sleep

sleep(timeout) 是设定一个固定的等待时长，代码运行到此处，会强行进行等待指定的时间，使用方便的同时，效率最低，不建议使用。

缺点：不能准确把握需要等待的时间（有时操作还未完成，等待就结束了，导致报错；有时操作已经完成了，但等待时间还没有到，浪费时间），如果在用例中大量使用，会浪费不必要的等待时间，影响测试用例的执行效率。

优点：使用简单，可以在调试时使用。

# 强行等待 10s
sleep(10)

二、隐式等待

隐式等待 也是设定一个固定的等待时间，对整个生命周期的元素都起作用，每一个元素都会等待加载完全，直到超过设定的等待时间。
其设置了一个最长等待时间，如果在规定时间内网页加载完成，则执行下一步，否则一直等到时间结束，然后执行下一步操作。
缺点：使用隐式等待，程序会一直等待整个页面加载完成，才会执行下一步操作；

但有时候页面想要的元素早已经加载完成了，但是因为网页上个别元素还没有加载完成，仍要等到页面全部完成才能执行下一步，使用也不是很灵活。

优点：隐性等待对整个driver的周期都起作用，所以只要设置一次即可。

# 隐式等待设定时长为5s
driver.implicitly_wait(5)

driver.get('http://www.google.com')

# 隐式等待所有元素加载完成,直到超过设定的最长时间
driver.find_element_by_id("element_id").click()

三、显示等待

显示等待 相比隐式等待更灵活，是先设定一个条件函数和一个最长等待时长，轮询判断条件函数的返回值，如果返回 True，则开始执行后面的操作，否则会一直等待，直到超时报元素未找到异常。

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait                           
from selenium.webdriver.support import expected_conditions as EC
           
driver = webdriver.Firefox()
driver.get("http://XX.com")
try:
    element =WebDriverWait(driver,10).until(EC.presence_of_element_located((By.ID, "Element")))
finally:
    driver.quit()

显示等待需要用到两个类：WebDriverWait和expected_conditions两个类， WebDriverWait指定轮询间隔、超时时间等，expected_conditions 指定了很多条件函数（也可以自定义条件函数），具体可以参考官网。

1、WebDriverWait

WebDriverWait(driver,timeout,poll_frequency=0.5,ignored_exceptions=None)

driver：浏览器驱动

timeout：最长超时时间，默认以秒为单位

poll_frequency：轮询的间隔步长，默认为0.5s

ignored_exceptions：超时后的抛出的异常信息，默认抛出NoSuchElementExeception异常

WebDriverWait（）类中有until()和until_not()方法：

2、until()和until_not()

WebDriverWait(self.driver, timeout, frequency).until(EC.visibility_of_element_located(loc))

until()、until_not()
WebDriverWait 一般是配合until() 或 until_not()方法，就能够根据判断条件而灵活地等待了。主要的意思就是：程序每隔xx秒看一眼，如果条件成立了，则执行下一步；否则继续等待，直到超过设置的最长时间，然后抛出TimeoutException异常。

格式：

WebDriverWait(driver, timeout).until(method, message=’’)
WebDriverWait(driver, timeout).until_not(method, message=’’)

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

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

这是错误的用法，这里的参数一定要是可以调用的，即这个对象一定有 call() 方法，否则会抛出异常：TypeError: 'xxx' object is not callable

在这里，我们可以用selenium提供的 expected_conditions 模块中的各种条件，也可以用WebElement的 is_displayed() 、is_enabled()、is_selected() 方法，或者用自己封装的方法都可以

3、expected_conditions

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

image.png image.png

1.title_is： 判断当前页面的title是否完全等于（==）预期字符串，返回布尔值

2. title_contains : 判断当前页面的title是否包含预期字符串，返回布尔值

3. presence_of_element_located : 判断某个元素是否被加到了dom树里，并不代表该元素一定可见

4. visibility_of_element_located : 判断某个元素是否可见. 可见代表元素非隐藏，并且元素的宽和高都不等于0

5.visibility_of : 跟上面的方法做一样的事情，只是上面的方法要传入locator，这个方法直接传定位到的element就好了

6.presence_of_all_elements_located : 判断是否至少有1个元素存在于dom树中。举个例子，如果页面上有n个元素的class都是'column-md-3'，那么只要有1个元素存在，这个方法就返回True

7. text_to_be_present_in_element : 判断某个元素中的text是否 包含 了预期的字符串

8. text_to_be_present_in_element_value : 判断某个元素中的value属性是否 包含 了预期的字符串

9. frame_to_be_available_and_switch_to_it : 判断该frame是否可以switch进去，如果可以的话，返回True并且switch进去，否则返回False

10. invisibility_of_element_located : 判断某个元素中是否不存在于dom树或不可见

11. element_to_be_clickable : 判断某个元素中是否可见并且是enable的，这样的话才叫clickable

12. staleness_of : 等某个元素从dom树中移除，注意，这个方法也是返回True或False

13. element_to_be_selected : 判断某个元素是否被选中了,一般用在下拉列表

14. element_selection_state_to_be : 判断某个元素的选中状态是否符合预期

15. element_located_selection_state_to_be : 跟上面的方法作用一样，只是上面的方法传入定位到的element，而这个方法传入locator

16. alert_is_present : 判断页面上是否存在alert

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