Selenium自动化

在显式等待WebDriverWait的until和until_not方法中我们经常要用到,它会根据网页标题、网址以及元素是否可见等条件来决定我们是否需要继续等待。我查看了一下源码,根据各大类型对它们做了个整理,方便记忆。

因为要使用 expected_conditions模块中的类,所以第一步肯定是要引入该模块,考虑到引用类时,很多地方都用到了locator定位范围,所以这里我们还要引入必须要引入 selenium.webdriver.common.by 的 By 模块,具体代码如下:

# 定位用
from selenium.webdriver.common.by import By
# 显示等待
from selenium.webdriver.support.ui import WebDriverWait
# until和until_not方法
from selenium.webdriver.support import expected_conditions as EC

接下来就是相关类的介绍以及简单使用示例:

1、title标题

(1)title_is 网页标题是否显示特定内容(必须完全符合),如果是返回True,否则返回False
# title标题
# title_is:网页标题是否显示特定内容(必须完全符合)
# title_contains:网页标题是否包含特定内容
title = WebDriverWait(driver, 5).until(EC.title_is('表单综合实例'))
print(f'title标题:真是True, 假是False. 结果:{title}')

(2)title_contains 网页标题是否包含特定内容,如果是返回True,否则返回False

result = EC.title_contains('百度')
print(result(self.driver))

2、url网址

(1)url_to_be 网页网址是否显示特定网址(必须完全符合),如果是返回True,否则返回False

# url网址
# url_contains:网页网址是否包含特定内容
# url_matches:网页网址是否匹配特定内容
url = WebDriverWait(driver, 5).until(EC.url_to_be('file:///D:/WebPage/page.html'))
print(f'url网址:真是True, 假是False. 结果:{url}')

(2)url_contains 网页网址是否包含特定内容,如果是返回True,否则返回False

# url网址
# url_contains:网页网址是否包含特定内容
# url_matches:网页网址是否匹配特定内容
url = WebDriverWait(driver, 5).until(EC.url_matches('file:///D:/WebPage/page.html'))
print(f'url网址:真是True, 假是False. 结果:{url}')

(3)url_matches 网页网址是否匹配特定内容,如果是返回True,否则返回False

#url是https://www.baidu.com/
pattern = r'/(w+)://([^/:]+)(:d*)?([^# ]*)/' #使用正则表达式,规定网址格式(格式要求以https开头)
result = EC.url_contains(pattern)
print(result(self.driver))

(4)url_changes 网页是否更改了,如果是返回True,否则返回False

3、element元素显示与可见
(1)presence_of_element_located 特定元素是否存在于页面DOM树中(存在非可见),如果是,返回该元素(单个元素),否则报错

# 存在非可见
# presence_of_element_located()
# 检查元素是否出现在页面的DOM上的期望。 这并不一定意味着元素是可见的。
locator = (By.XPATH, '//input[@id="alert"]')
ele = WebDriverWait(driver, 3).until(EC.presence_of_element_located(locator))

(2)presence_of_all_elements_located 定位的元素范围内,是否至少有一个元素存在于页面当中,如果是,返回满足条件的所有元素组成的List,否则返回空List

# 检查网页上是否至少存在一个元素的期望, 一旦找到, 以列表的形式返回
# presence_of_all_elements_located()
locator = (By.XPATH, '//input[@id="alert"]')
ele = WebDriverWait(driver, 3).until(EC.presence_of_all_elements_located(locator))

(3)visibility_of_element_located 特定元素是否存在于DOM树中并可见(存在及可见),如果是返回该元素(单个元素),否则报错

# 存在且可见
# visibility_of_element_located ()
# 期望检查某个元素是否出现在页面的DOM中且可见。可见性意味着元素不仅被显示,而且其高度和宽度都大于0。
locator = (By.XPATH, '//input[@id="alert"]')
ele = WebDriverWait(driver, 3).until(EC.visibility_of_element_located(locator))
ele.click()

  注:visibility_of_element_located 与 presence_of_element_located作用类似,但前者无所谓可见与否,所以在性能上略胜一筹。

(4)invisibility_of_element_located 特定元素是否不可访问或不存在于DOM树中,如果不存在则返回True,否则返回True

  注:invisibility_of_element_located 刚好与 visibility_of_element_located的作用相反,且返回的结果大不相同。

(5)invisibility_of_element 特定元素是否不可访问或不存在于DOM树中,如果不存在则返回True,否则返回True

  注:invisibility_of_element_located 与 invisibility_of_element 作用类似,但前者传的是定位范围locator,后者可以是定位范围(仅text文本),也可以是元素element。

(6)visibility_of 特定元素是否存在于DOM树中并可见,如果是返回该元素(单个元素),否则报错

element = self.driver.find_element_by_id('kw')
result = EC.visibility_of(element)
print(result(self.driver))

  注:visibility_of_element_located 与 visibility_of 作用类似,但是前者传入的是定位范围locator,后者传入的是元素element,另外 invisibility_of_element 与 visibility_of 作用相反,且返回的结果大不相同。

(7)visibility_of_any_elements_located 定位的元素范围内,是否至少有一个元素存在于DOM树中并可见,如果是,返回满足条件的所有元素组成的List,否则返回空List

(8)visibility_of_all_elements_located 定位的元素范围内,是否所有元素都存在于DOM树中并且可见,如果是,以List形式返回元素,否则返回False

(9)element_to_be_clickable 特定元素是否可点击,如果可以则返回该元素,否则返回False

locator = (By.ID, 'su') #<su>是一个可点击的按钮
result= EC.element_to_be_clickable(locator)
print(result(self.driver))

(10)staleness_of 特定元素是否不再附加于于DOM树中,如果不再附加返回True,否则返回False

4、text文本

(1)text_to_be_present_in_element 特定文本是否出现在特定元素中,如果是则返回True,否则返回False

# text文本 title (判断文本对不对)
# text_to_be_present_in_element:特定文本是否出现在特定元素中
# text_to_be_present_in_element_value:判断某文本是否是存在于特定元素的value值中
 locator = (By.XPATH, '//button[@value="注册"]')
ele = WebDriverWait(driver, 10).until(EC.text_to_be_present_in_element(locator, '注册'))
print(f'text文本:真是True, 假是False. 结果:{ele}')

(2)text_to_be_present_in_element_value 判断某文本是否是存在于特定元素的value值中,如果是则返回True,否则返回False

locator = (By.ID, 'su')
element = EC.text_to_be_present_in_element_value(locator, '百度一下') #查看<su>的value值中是否包含'百度一下'
print(element(driver))

  注:如果该特定元素没有value值,也会返回False

5、frame
(1)frame_to_be_available_and_switch_to_it frame窗口是否可被切换,如果是返回True,否则返回False

# frame切换

# frame_to_be_available_and_switch_to_it:frame窗口是否可被切换,如果可用,它将给定的驱动程序切换到指定的帧。 ele = (By.XPATH, '//iframe[@id="idframe1"]') frame = WebDriverWait(driver, 10).until(EC.frame_to_be_available_and_switch_to_it(ele)) print(f'frame切换:真是返回alert对象, 假是False. 结果:{frame}')

6、Select
(1)element_to_be_selected 特定元素是否被选中,如果是,返回True,否则返回False

element= self.driver.find_element_by_id('select1')
result = EC.element_to_be_selected(locator)
print(result(self.driver))

(2)element_located_to_be_selected

locator = (By.ID, 'checkbox1')
result = EC.element_located_to_be_selected(locator)
print(result(self.driver))

(3)element_selection_state_to_be 特定元素的选中状态是否与预期相同,相同则返回True,不同则返回False

checkbox = self.driver.find_element_by_id('checkbox1')
result = EC.element_selection_state_to_be(checkbox, True) #第二个参数可设置为True或False
print(result(self.driver))

(4)element_located_selection_state_to_be 特定元素的选中状态是否与预期相同,相同则返回True,不同则返回False

locator = (By.ID, ‘checkbox1’)
result = EC.element_located_selection_state_to_be(locator, True) #第二个参数可设置为True或False
print(result(self.driver))

  注:element_selection_state_to_be 与 element_located_selection_state_to_be 作用类似,只是传递的参数一个是元素element,一个是作用范围locator。

7、windows窗口

(1)number_of_windows_to_be 特定窗口数和实际窗口数是否一致,如果是返回True,否则返回False

# windows窗口(1)
# (1)number_of_windows_to_be   特定窗口数和实际窗口数是否一致,如果是返回True,否则返回False
#   填入int类型数据
windows = WebDriverWait(driver, 3).until(EC.number_of_windows_to_be(1))  # 期望窗口设置为1个
print(f'窗口数:真是True, 假是False. 结果:{windows}')

(2)new_window_is_opened 新窗口是否打开,如果是返回True,否则返回False

# windows窗口(2)  期望打开一个新窗口并增加窗口句柄的数量
# (2)new_window_is_opened  新窗口是否打开,如果是返回True,否则返回False
#   1、先获取所有窗口句柄,2、操作打开新窗口,3、使用new_window_is_opened判断是否打开一个新窗口
current_handles = driver.window_handles  # 获得当前所有句柄数量
new_window = WebDriverWait(driver, 3).until(EC.new_window_is_opened(current_handles))
print(f'打开一个新窗口:真是True, 假是False. 结果:{new_window}')

8、alert对话框

(1)alert_is_present 弹出框是否存在,如果是,切换到alert,否则返回false

# alert对话框
# (1)alert_is_present   弹出框是否存在,如果是真返回alert对象,否则返回false
alert = WebDriverWait(driver, 3).until(EC.alert_is_present())
print(f'alert对话框:真是返回alert对象, 假是False. 结果:{alert}')
原文地址:https://www.cnblogs.com/yongzhuang/p/15028052.html