1、expected_conditions模块介绍
expected_conditions
是Selenium的一个模块,主要用于对页面元素的加载进行判断,包括元素是否存在,可点击等等。-
Expected Conditions
的使用场景一版有两种:- 直接在断言中使用
- 与
WebDriverWait
配合使用,显示等待页面上元素出现或者消失。
-
一般情况下,我们在使用
expected_conditions
模块时都会对其进行重命名,通过as关键字对其重命名为EC
。from selenium.webdriver.support import expected_conditions as EC
2、expected_conditions模块常用类
-
title_is(title)
title_is(title)
判断网页title是否是特定文本(英文区分大小写),若完全相同则返回True,否则返回False。 -
title_contains(title)
title_contains(title)
判断网页title是否包含特定文本(英文区分大小写),若包含则返回True,不包含返回False。 -
presence_of_element_located(locator)(重点,常用)
presence_of_element_located(locator)
判断一个元素存在于页面DOM树中,存在则返回元素本身,不存在则报错。locator
为一个(by, path)元祖,这个(by, path)的by是Selenium的一个类selenium.webdriver.common.by.By
,包括CLASS_NAME
,CSS_SELECTOR
,ID
,LINK_TEXT,NAME
,PARTIAL_LINK_TEXT
,TAG_NAME
和XPATH
,和我们8种基本元素定位中使用的方法相同。 -
presence_of_all_elements_located(locator)
presence_of_all_elements_located(locator)
判断定位的元素范围内,至少有一个元素存在于页面当中,存在则以list形式返回元素本身,不存在则报错。 -
visibility_of_element_located(locator)
visibility_of_element_located(locator)
判断特定元素是否存在于DOM树中并且可见,可见意为元素的高和宽都大于0,元素存在返回元素本身,否则返回False。这个类和
presence_of_element_located(locator)
有点像,但后者只强调元素存在于DOM树中,可见不可见无所谓,而前者要求必须高和宽必须都大于0,因此后者在性能上会稍微快一点点。 -
visibility_of(element)
visibility_of(element)
同上面visibility_of_element_located(locator)
,不过参数从locator的元组变为元素。 -
invisibility_of_element_located(locator)
invisibility_of_element_located(locator)
判断元素是否隐藏。 -
text_to_be_present_in_element(locator,text)
text_to_be_present_in_element(locator,text)
判断给定文本是否出现在特定元素中,若存在则返回True,不存在返回False。 -
text_to_be_present_in_element_value(locator,text)
text_to_be_present_in_element_value(locator,text)
判断某文本是否是存在于特定元素的value值中,存在则返回True,不存在则返回False,对于查看没有value值的元素,也会返回False。 -
frame_to_be_available_and_switch_to_it(locator)
frame_to_be_available_and_switch_to_it(locator)
判断某个frame是否可以切换过去,若可以则切换到该frame,否则返回False 。 -
element_to_be_clickable(locator)
element_to_be_clickable(locator)
判断某元素是否可访问并且可启用,比如能够点击,若可以则返回元素本身,否则返回False。 -
staleness_of(element)
staleness_of(element)
判断某个元素是否不再附加于于DOM树中,不再附加的话返回True,依旧存在返回False。可以用于判断页面是否刷新了。 -
alert_is_present
alert_is_present
判断alert是否存在,若存在则切换到alert,若不存在则返回False。 -
element_to_be_selected(element)
element_to_be_selected(element)
判断某元素是否被选中。 -
element_located_to_be_selected(locator)
element_located_to_be_selected(locator) 判断某元素是否被选,locator为一个(by, path)元祖。
-
element_selection_state_to_be (element, is_selected)
element_selection_state_to_be (element, is_selected)
判断某元素的选中状态是否与预期相同,相同则返回True,不同则返回False。 -
element_located_selection_state_to_be(locator, is_selected)
element_located_selection_state_to_be(locator, is_selected)
判断某元素是否与预期相同,相同则返回True,不同则返回False,locator为一个(by, path)元祖。
总结:这些方法与
WebDriverWait
类和until()
、until_not()
方法组合能使用,够实现很多判断功能,如果能自己灵活封装,将会大大提高脚本的稳定性。