特点:
- 针对具体元素进行时间等待
- 可以自定义等待时长和间隔时间
- 按照设定的时间,不断定位元素,定位到了直接执行下一步操作
- 如在设定时间内没定位到元素,则报错(TimeOutException)
显示等待概念:
设置一个等待时间和一个条件,在规定时间内,每隔一段时间查看下条件是否成立,如果成立那么程序就继续执行,否则就提示一个超时异常(TimeoutException)。
在使用显示等待时;
需要结合Selenium的WebDriverWait和expected_conditions模块来实现。
- WebDriverWait负责等待的设置,
- expected_conditions模块提供了一系列常用的条件,可以根据具体的需求选择合适的条件
需要导入两个包
# 导入selenium模块中的WebDriverWait类,用于等待特定条件出现后再执行下一步操作
from selenium.webdriver.support.ui import WebDriverWait
# 导入selenium模块中的expected_conditions模块的EC别名,用于定义预期条件
from selenium.webdriver.support import expected_conditions as EC
使用步骤:
1)初始化WebDriverWait对象,指定等待时间和浏览器驱动。
eg:wait = WebDriverWait(driver, timeout=3)
2)调用until方法,传入要等待的条件。
eg:wait.until(condition)
3)condition条件通过:expected_conditions as EC 调用指定条件
eg:wait.until(EC.condition)
4)在until方法中,会不断地轮询条件是否满足,直到条件满足或超时时间到达。还有 until_not()正好与until相反
5)条件满足后,继续执行后续代码。
6)如果超过超时时间后仍未满足条件,则抛出TimeoutException异常。
WebDriverWait参数说明:
WebDriverWait(driver, timeout=3).until(some_condition)
driver:浏览器驱动对象
timeout:最长等待时间轮询时间:默认是以每500ms轮询一次,也可以指定
.until(some_condition):调用until()方法并传递一个特定的条件some_condition。该方法将等待直到条件满足或超时时间达到
这里是一个使用until()方法的例子,它等待页面标题包含特定文本:
from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 创建WebDriver实例,并指定使用Chrome浏览器驱动
driver = webdriver.Chrome()
# 导航到菜鸟教程网页
driver.get("https://www.runoob.com/")
# 显式等待直到页面标题包含“菜鸟教程”
wait = WebDriverWait(driver, 10)
title_contains_runoob = EC.title_contains("菜鸟教程")
title = wait.until(title_contains_runoob)
# 输出页面标题
print(title)
# 关闭浏览器
driver.quit()
这里是一个使用until_not()方法的例子,它等待文本框中的值被清除:
from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 创建WebDriver实例,并指定使用Chrome浏览器驱动
driver = webdriver.Chrome()
# 导航到百度网页
driver.get("https://www.baidu.com")
# 获取文本框元素并输入文本
input_elem = driver.find_element("css selector", "input[name='wd']")
input_elem.send_keys("python")
# 显式等待直到文本框中的值被清除
wait = WebDriverWait(driver, 10)
value_cleared = EC.text_to_be_present_in_element_value(("css selector", "input[name='wd']"), "")
input_elem.clear()
wait.until_not(value_cleared)
# 关闭浏览器
driver.quit()
expected_conditions as EC 条件方法
先导包
# 导入expected_conditions类,并取别名为 EC
from selenium.webdriver.support import expected_conditions as EC
条件1:title_is
检查页面标题的期望。title是预期的标题,必须完全匹配如果标题匹配,则返回True,否则返回false。
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium import webdriver
# 实例化驱动对象
driver = webdriver.Chrome()
driver.get("http://shop.aircheng.com/simple/login")
# 显示等待 页面标题
# 等待10s
wait = WebDriverWait(driver, 5)
# 获取页面标题
title = driver.title # 用户登录 - iWebShop商城演示
# title:"预期标题" message:提示消息
wait.until(EC.title_is(title="用户登录 - iWebShop商城演示3"), message='标题不匹配')
print(title)
# 不匹配报错
D:\Scripts\python.exe D:\桌面\Hualenium_demo_6_1\demo9\显示等待2.py
Traceback (most recent call last):
File "D:\桌面\HuaCe_Python\code_py\selenium_demo_6_1\demo9\显示等待2.py", line 15, in <module>
wait.until(EC.title_is(title="用户登录 - iWebShop商城演示3"), message='标题不匹配')
File "D:\桌面\HuaCe_Python\code_py\selenium_demo_6_1\venv\lib\site-packages\selenium\webdriver\support\wait.py", line 105, in until
raise TimeoutException(message, screen, stacktrace)
selenium.common.exceptions.TimeoutException: Message: 标题不匹配
条件2:title_contains
检查标题是否包含区分大小写的子字符串。title是所需的标题片段当标题匹配时返回True,否则返回False
用法与title_is一样,唯一区别就是:
- title_is是完全相等,
- title_contains是包含
条件3:presence_of_element_located
检查元素是否存在于页面。这并不一定意味着元素是可见的。定位器-用于查找元素找到WebElement后返回该WebElemen
#导包
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
from selenium import webdriver
class Brouser:
fox = webdriver.Firefox()
wait = WebDriverWait(fox, 5)
def get_url(self,url):
self.fox.get(url)
def presence_located(self,value,*ele):
el = self.wait.until(EC.presence_of_element_located(ele),message='没有发现期望的元素')
el.send_keys(value)
if __name__ == '__main__':
b = Brouser()
b.get_url('http://shop.aircheng.com/simple/login')
b.presence_located('qingan',By.NAME,'login_info')
条件4:visibility_of_element_located
检查元素是否存在于页面和可见。可见性意味着不仅显示元素但其高度和宽度也大于0。定位器-用于查找元素找到并可见WebElement后返回该WebElement
用法与presence_of_element_located一样,唯一区别就是:
- visibility_of_element_located:检查元素是否出现,元素为:可见或不可见
- presence_of_element_located:检查元素是否出现,元素必须为:可见
条件5:url_to_be
检查当前url的期望值。url是预期的url,必须完全匹配。如果url匹配,则返回True,否则返回false
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
from selenium import webdriver
class Brouser:
fox = webdriver.Firefox()
wait = WebDriverWait(fox, 5)
def get_url(self,url):
self.fox.get(url)
def url_be(self,url):
self.wait.until(EC.url_to_be(url))
if __name__ == '__main__':
b = Brouser()
b.get_url('http://shop.aircheng.com/simple/login')
b.url_be('http://shop.aircheng.com/simple/login')
判断url还有另外的几种方式,都大同小异
url_matches: 检查当前url的期望值。pattern是预期的模式,必须是完全匹配的如果url匹配,则返回True,否则返回false。
url_contains: 检查当前url是否包含区分大小写的子字符串。url是所需url的片段,url匹配时返回True,否则返回False
url_changes : 检查当前url的期望值。url是预期的url,不能完全匹配如果url不同,则返回True,否则返回false。
条件6:visibility_of
检查已知存在于页面的DOM是可见的。可见性意味着元素不仅仅是显示,但高度和宽度也大于0。元素是WebElement在WebElement可见时返回(相同的)WebElement
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
from selenium import webdriver
class Brouser:
fox = webdriver.Firefox()
wait = WebDriverWait(fox, 5)
def get_url(self,url):
self.fox.get(url)
def visibility_(self,*ele):
el = self.wait.until(EC.visibility_of(self.fox.find_element(*ele)))
el.click()
if __name__ == '__main__':
b = Brouser()
b.get_url('http://shop.aircheng.com/simple/login')
b.visibility_(By.NAME, 'remember')
这里值得注意的是
visibility_of_element_located跟visibility_of很类似。与上面的写法不同EC.visibility_of里面写的是定位,而非单纯的元素。这也是一个区别点。在后续的使用中注意一下。
代码示例1
"""需求:等待页面出现标题"""
# 创建WebDriver实例
driver = webdriver.Chrome()
# 导航到网页
driver.get("https://www.csdn.net")
# 等待页面标题包含"CSDN"
wait = WebDriverWait(driver, 5)
title_contains_csdn = EC.title_contains("CSDN")
wait.until(title_contains_csdn)
# 输出页面标题
print(driver.title)
代码示例2
# 导包
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 默认是以每500ms轮询一次until中的条件,传入的超时时间是10s
WebDriverWait(driver,10).until(EC.presence_of_element_located((By.ID,'kw')))
# 设置每1s轮询一次until中的条件,传入的超时时间是10s
WebDriverWait(driver,10,1).until(EC.presence_of_element_located((By.ID,'kw')))
自定义封装-显示等待
class BackLogin:
@classmethod
def wait(cls, driver, func):
return WebDriverWait(driver, 5).until(func)
# need_wait:形参代表默认值False不需要触发显示等待
def find_element(self, by, value, driver, need_wait=False):
def f(driver):
# 判断当前元素是否有文本属性
if driver.find_element(by, value).text:
msg = driver.find_element(by, value).text
if need_wait: # 是否触发隐式等待,返回实际提示信息结果
return msg
else:
return True
else:
return True
# 类中可以通过self对象调用类方法
self.wait(driver, f)
return driver.find_element(by, value)
调用
# 获取实际结果
msg = BackLogin().find_element(*BackLogin.res_txt, driver,need_wait=True).text
print(msg)
assert msg == "验证码不能为空"
参考博客: