特点：

• 针对具体元素进行时间等待

• 可以自定义等待时长和间隔时间

• 按照设定的时间，不断定位元素，定位到了直接执行下一步操作

• 如在设定时间内没定位到元素，则报错（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)

3）在until方法中，会不断地轮询条件是否满足，直到条件满足或超时时间到达。还有                 until_not()正好与until相反

4）条件满足后，继续执行后续代码。

5）如果超过超时时间后仍未满足条件，则抛出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 == "验证码不能为空"

参考博客：Selenium 等待方式详解_selenium等待元素可见-CSDN博客

selenium--显示等待(中)--详解篇_presenceofelementlocated-CSDN博客