【学习笔记】Selenium 等待方式详解
学习目的:
详细了解Selenium等待的作用和各等待方式的特点。
第一部分:等待的用处
在Selenium脚本执行过程中,对于元素的定位是有一个超时的时间(大致在1-3秒),若超出此时间仍然定位不到元素,就会抛出异常,中止脚本执行。而页面加载是需要时间且时常不可控的,为了保证脚本执行的稳定性,需要手动设置等待时长。
第二部分:等待方式
隐式等待(Implicit Wait)
说明:隐式等待设置了一个全局的等待时间,告诉Selenium在查找页面元素时,如果元素没有立即出现,就等待一段时间再进行查找,若在规定的时间内元素出现了,则执行下一步,否则抛出异常
# 设置隐式等待时间,单位为秒
driver.implicitly_wait(seconds)
注意:
- 隐式等待的作用域是全局的,在整个脚本的生命周期内只需设置一次,如果再次设置,后一次的设置会覆盖前一次的设置。
- 隐式等待会让程序一直等待整个页面加载完成,这可能会导致脚本执行时间过长而影响效率。
显式等待 (ExplicitWait)
说明:
- 显式等待是针对指定元素进行等待的方式,等到代码运行到显式等待这一行时再进行等待。
- 显式等待是在代码中明确地指定一个特定的条件,直到条件满足后再继续执行后续代码,比如等待元素可见、可点击、可输入等。
- 在使用显示等待时,通常会结合TimeoutException、WebDriverWait模块和ExpectedCondition模块来使用。WebDriverWait负责等待的设置,ExpectedConditio模块提供了一系列常用的条件,可以根据具体的需求选择合适的条件,而TimeoutException则设置超时后抛出的异常。
语法
# 显示等待语法
WebDriverWait(driver, timeout). TimeoutException(ExpectedConditio)
该语法的具体含义为:
- WebDriverWait(driver, timeout) 创建一个WebDriverWait对象,将传递给它的driver参数作为被等待的WebDriver实例,并设置最长等待时间(timeout)。
- . TimeoutException(ExpectedConditio)调用一个TimeoutException()方法并传递一个ExpectedConditio的条件。
- 该方法将等待直到条件满足或超时时间达到。
WebDriverWait()参数说明:
参数 | 描述 |
---|---|
driver | WebDriver实例,用于等待。 |
timeout | 最长等待时间,超时将抛出TimeoutException异常。 |
poll_frequency | 调用until或until_not中的方法之前的休眠秒数,默认为500毫秒。 |
ignored_exceptions | 忽略某些异常并不抛出异常。 |
message | 超时异常描述信息。 |
TimeoutException()方法及参数说明:
方法名 | 描述 | 参数 |
---|---|---|
until() | 等待,直到条件为真 | - method:一个预期条件,可以是一个内置条件或自定义条件对象。 - message (可选):超时时要显示的错误消息。 |
until_not() | 等待,直到条件不为真 | - method:一个预期条件,可以是一个内置条件或自定义条件对象。 - message (可选):超时时要显示的错误消息。 |
ExpectedConditio常用条件及说明:
条件语法 | 条件说明 |
---|---|
title_is(title) | 检查页面的标题是否正好等于期望的标题。 |
title_contains(substr) | 检查页面的标题是否包含一个子串。 |
presence_of_element_located(locator) | 检查是否在页面的DOM中至少有一个元素存在。 |
visibility_of_element_located(locator) | 检查一个元素是否在页面中可见。元素的可见性不仅意味着元素非隐藏,而且元素的宽和高都大于0。 |
visibility_of(element) | 检查元素是否可见。和visibility_of_element_located类似,但是参数是一个已经在DOM中的元素。 |
presence_of_all_elements_located(locator) | 检查是否所有匹配的元素都存在于页面的DOM中。 |
text_to_be_present_in_element_value(locator, text) | 检查元素的值是否包含期望的字串。 |
text_to_be_present_in_element(locator, text) | 检查元素的文本是否包含期望的字串。 |
frame_to_be_available_and_switch_to_it(locator) | 检查是否可以切换到指定的frame。 |
invisibility_of_element_located(locator) | 检查元素是否处于不可见状态。 |
element_to_be_clickable(locator) | 检查元素是否在页面中可见并且可以被点击。 |
staleness_of(element) | 检查一个元素是否已经从DOM中移除。 |
element_to_be_selected(element) | 检查元素是否被选中。 |
element_located_to_be_selected(locator) | 检查一个元素是否可以被选中。 |
element_selection_state_to_be(element, is_selected) | 检查一个元素的选中状态是否符合预期。 |
element_located_selection_state_to_be(locator, is_selected) | 检查一个元素的选中状态是否可以符合预期。 |
alert_is_present() | 检查是否有alert弹出。 |
显式等待应用例子:
显式等待直到页面标题包含“摸鱼派”。
from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 初始化并打开Edge浏览器
driver = webdriver.Edge()
# 访问鱼排
driver.get('https://fishpi.cn/')
# 显式等待直到页面标题包含“摸鱼派”
T = WebDriverWait(driver, timeout=10).until (EC.title_contains("摸鱼派"))
# 输出等待结果
print(T)
# 关闭浏览器
driver.quit()
强制等待(Explicit Wait)
说明:使用time库下的sleep()方法来让程序“睡一会”,不考虑代码的逻辑,只要运行到sleep,程序就进入到等待的状态,等待时间由参数(秒)决定,等待结束之后,再继续运行后续的代码。
# 导入time模块,用于等待
import time
# 强制等待
time.sleep(seconds)
煤球好努力
大佬大佬
同时设置了隐式和显式,那以谁为准呢?~~~
如果有冲突,显式等待会覆盖隐式等待。
没有啥冲突的,隐式是全局性质的,显式是针对某个元素的单独设置。
你可以试试,显式设置个时间短的,隐式设置个时间长的,超过显式的时间后,代码报不报异常就知道了~~~
所以他俩是各自生效,即使等待重合了也是独立计算的,是吗