selenium系列(2-3)-元素等待
1. 元素等待
1.1 什么是元素等待？
概念：WebDriver定位页面元素时如果未找到，会在指定时间内一直等待的过程；
1.2 为什么要设置元素等待？
1. 由于网络速度原因
2. 电脑配置原因
3. 服务器处理请求原因
WebDriver元素等待有几种类型呢？
1.3 元素等待类型
1. 显式等待
2. 隐式等待
2. 显式等待
概念：使WebDriver等待指定元素条件成立时继续执行，否则在达到最大时长时抛出超时异常(TimeoutException)
提示：
1). 在WebDriver中把显式等待的相关方法封装在WebDriverWait类中
2). 等待是判定条件成立时，那如何判断条件成立？相关判断的方法封装在expected_conditions类中2.1 实现难点分析
1. 导包 等待类 --> from selenium.webdriver.support.wait import WebDriverWait
2. 导包 判断条件 --> from selenium.webdriver.support import expected_conditions as EC
(将expected_conditions 通过as关键字起个别名：EC)
3. WebDriverWait(driver, timeout, poll_frequency=0.5)
1). driver：浏览器对象
2). timeout：超时的时长，单位：秒
3). poll_frequency：检测间隔时间，默认为0.5秒
4. 调用方法 until(method)：直到..时
1). method：调用EC.presence_of_element_located(element)
element：调用By类方法进行定位2.2 案例-1 代码示例
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.wait import WebDriverWait
url = r'E:\测试\课件\Web自动化\Web自动化课件\02img\注册A.html'
driver = webdriver.Firefox()
driver.get(url)
element = WebDriverWait(driver, 5).until(EC.presence_of_element_located((By.ID, 'userA')))
element.send_keys("admin")
2.3 源码分析
## ## test.py
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.wait import WebDriverWait
WebDriverWait(driver,10,0.6).until(EC.presence_of_element_located()) # util 参数返回值为_predicate
## expected_conditions.py
def presence_of_element_located(locator):
""" An expectation for checking that an element is present on the DOM
of a page. This does not necessarily mean that the element is visible.
locator - used to find the element
returns the WebElement once it is located
"""
def _predicate(driver):
return driver.find_element(*locator)
return _predicate
## expected_conditions.py
## expected_conditions.py
def until(self, method, message=''):
"""Calls the method provided with the driver as an argument until the \
return value does not evaluate to ``False``.
:param method: callable(WebDriver)
:param message: optional message for :exc:`TimeoutException`
:returns: the result of the last call to `method`
:raises: :exc:`selenium.common.exceptions.TimeoutException` if timeout occurs
"""
screen = None
stacktrace = None
end_time = time.time() + self._timeout
while True:
# 如果时间内，一直寻找元素，时间间隔为self._timeout，超过总时间就报超时错误
try:
value = method(self._driver) # 此时method 即为_predicate，所以调用_predicate(self.driver)
if value:
return value 只要找到了才会返回element
except InvalidSelectorException as e:
raise e
except self._ignored_exceptions as exc: # self._ignored_exceptions默认值只有IGNORED_EXCEPTIONS = (NoSuchElementException,)，可以实例化WebDriverWait传入 ignored_exceptions
screen = getattr(exc, 'screen', None)
stacktrace = getattr(exc, 'stacktrace', None)
time.sleep(self._poll)
if time.time() > end_time:
break
raise TimeoutException(message, screen, stacktrace) #超过总时间就报超时错误
2.4 selenium 条件分析
title_is 判断title是否出现
title_contains 判断title页面标题是否包含某些字符
presence_of_element_located 判断某个元素是否被加载到了dom树里，但是并不代表这个元素可见
url_contains 判断当前url是否包含某个url
url_matches 判断当前url是否符合某种格式
url_to_be 判断当前url是否出现
url_changes 判断当前url是否已经发生了变化
visibility_of_element_located 判断某个元素是否被添加到了dom树里，且宽高都大于0
visibility_of 判断看某个元素是否可见
presence_of_all_elements_located 判断至少有一个元素存在于dom树中，返回所有定位到的元素
visibility_of_any_elements_located 判断至少有一个元素在页面中可见
visibility_of_all_elements_located 判断是否所有元素都在页面中可见
text_to_be_present_in_element 判断指定的元素中是否包含了预期的字符串
text_to_be_present_in_element_value 判断指定的元素属性值中是否包含了预期的字符串
frame_to_be_available_and_switch_to_it 判断iframe是否可以switch进去
invisibility_of_element_located 判断某个元素是否在dom中不可见
element_to_be_clickable 判断某个元素是否可见并且是enable的，也就是说是是否可以点击
staleness_of 等待某个元素从dom中删除
element_to_be_selected 判断某个元素是否被选中了，一般用于下拉列表中
element_located_to_be_selected 与上面的意思一样，只不过上面实例化的时候传入的是元素对象，这个传入的是定位
element_selection_state_to_be 判断某个元素的选中状态是否符合预期
element_located_selection_state_to_be 与上面一样，只不过传值不同而已
number_of_windows_to_be 判断当前窗口数是否等于预期
new_window_is_opened 判断是否有窗口增加
alert_is_present 判断页面是否有弹窗
> 当然我们也可以根据自己的需要自定义
#### 自定义条件类
> 上面是自己实现的一个条件类，根据页面的url和标题来判断页面是否被正确加载，
```
from selenium import webdriver
from selenium.webdriver.support.wait import WebDriverWait
import pytest
class page_is_load:
def __init__(self, expected_title, expected_url):
self.expected_title = expected_title
self.expected_url = expected_url
def __call__(self, driver):
is_title_correct = driver.title in self.expected_title
is_url_correct = driver.current_url == self.expected_url
return is_title_correct and is_url_correct
class TestCase():
def setup(self):
self.driver = webdriver.Chrome()
self.driver.get('http://www.baidu.com/')
# sleep(2)
def __call__(self):
print(self.driver.title)
def test_wait(self):
wait = WebDriverWait(self.driver, 10)
wait.until(page_is_load("百度一下，你就知道", "https://www.baidu.com/"))
if __name__ == '__main__':
pytest.main(['-s'])
```
3. 隐式等待
说明：等待元素加载指定的时长，超出抛出NoSuchElementException异常，实际工作中，一般都使用隐式等待；
显式与隐式区别：
1. 作用域：显式等待为单个元素有效，隐式为全局元素
2. 方法：显式等待方法封装在WebDriverWait类中，而隐式等待则直接通过浏览器实例化对象调用
3.1 隐式等待调用方法
方法：implicitly_wait(timeout)
(timeout：为等待最大时长，单位：秒)
调用：driver.implicitly_wait(10)
(driver：为浏览器实例化对象名称)
3.2 隐式等待执行-说明
如果定位某一元素定位失败，那么就会触发隐式等待有效时长，如果在指定时长内加载完毕，则继续执行，否则
抛出NoSuchElementException异常，如果元素在第一次就定位到则不会触发隐式等待时长；
4. 元素等待-总结
1. 为什么要设置元素等待
2. 显式等待与隐式等待区别
3. 掌握隐式等待