selenium中expected_conditions模块常用方法

一、expected_conditions模块介绍

1. expected_conditions是Selenium的一个模块，主要用于对页面元素的加载进行判断，包括元素是否存在，可点击等等。
2. Expected Conditions的使用场景一般有两种：

• 直接在断言中使用
• 与WebDriverWait配合使用，显示等待页面上元素出现或者消失。

一般情况下，我们在使用

expected_conditions

模块时都会对其进行重命名，通过as关键字对其重命名为

EC

。

from selenium.webdriver.support import expected_conditions as EC

二、expected_conditions模块常用方法

1、判断网页title是否是特定文本（英文区分大小写），若完全相同则返回True，否则返回False。

title_is( String title)

2、判断网页title是否包含特定文本（英文区分大小写），若包含则返回True，不包含返回False。

title_contains( String title)

3、判断当前页面的url是否等于预期值

url_to_be( String url)

4、判断页面是否跳转成功，成功返回true，否则返回false

url_changes(url)

5、判断当前页面的url是否包含预期字符串

url_contains( String fraction) 

6、等待url中出现指定字符串或正则表达式（可以使用“或”语法,例如想检测url中是否有“ncc”或者“map”，就可以传“ncc|map”）

url_matches( String regex) 

7、判断一个元素存在于页面DOM树中，存在则返回元素本身，不存在则报错。

presence_of_element_located( By locator) 

8、判断定位的元素范围内，至少有一个元素存在于页面当中，存在则以list形式返回元素本身，不存在则报错。

presence_of_all_elements_located( By locator) 

9、判断特定元素是否存在于DOM树中并且可见，可见意为元素的高和宽都大于0，元素存在返回元素本身，否则返回False。

visibility_of_element_located( By locator) 

10、

同上面

visibility_of_element_located(locator)

，不过参数从locator的元组变为元素，如果存在就返回该元素。

visibility_of(element)

11、判断某组元素是否可见

visibility_of_all_elements_located( By locator) 

12、判断是否有一个元素在页面可见，如果定位到就返回列表。

visibility_of_any_elements_located(By locator) 

13、判断给定文本是否出现在特定元素中，若存在则返回True，不存在返回False。

text_to_be_present_in_element(By locator, String text) 

14、判断某文本是否是存在于特定元素的value值中，存在则返回True，不存在则返回False，对于查看没有value值的元素，也会返回False。

text_to_be_present_in_element_value(final By locator, final String text) 

15、判断某个frame是否可以切换过去，若可以则切换到该frame，否则返回False 。

frame_to_be_available_and_switch_to_it(final By locator) 

16、判断某个元素中是否不存在于dom树或不可见，如果可见返回false，不可见返回这个元素。

invisibility_of_element_located(final By locator) 

17、同上面的invisibility_of_element_located一样，只不过传值是传element

invisibility_of_element(final By element) 

18、如果给定元素是可见的且具有非零大小，否则为null

element_if_visible(WebElement element) 

19、判断某元素是否可访问并且可启用，比如能够点击，若可以则返回元素本身，否则返回False。

element_to_be_clickable(final By locator) 

20、判断某个元素是否被选中了,一般用在下拉列表

element_to_be_selected(WebElement element)

21、判断某个元素是否被选中了,一般用在下拉列表，locator为一个(by, path)元组。

element_located_to_be_selected(By locator) 

22、判断某元素的选中状态是否与预期相同，相同则返回True，不同则返回False。

element_selection_state_to_be( WebElement element,  boolean selected) 

23、跟上面的element_selection_state_to_be一样，只不过传入类型为locator。

element_located_selection_state_to_be(final By locator, final boolean selected) 

24、判断页面上是否存在alert，若存在则切换到alert，若不存在则返回False。

alert_is_present() 

25、判断一个元素是否仍在DOM中或等待从dom中移除，传入WebElement对象，可以判断页面是否刷新了，不存在的话返回True，依旧存在返回False

staleness_of(final WebElement element) 

总结：这些方法与

WebDriverWait

类和

until()

、

until_not()

方法组合能使用，够实现很多判断功能，如果能自己灵活封装，将会大大提高脚本的稳定性。

二、使用示例

#encoding:utf-8
# example of how to use https://github.com/SeleniumHQ/selenium/blob/master/py/selenium/webdriver/support/expected_conditions.py
 
from selenium.webdriver.support import expected_conditions as EC
 
 
dr = webdriver.Chrome()
url = 'http://www.baidu.com'
search_text_field_id = 'kw'
dr.get(url)
 
class ECExample(unittest.TestCase):
 
  def test_title_is(self):
    ''' 判断title是否符合预期 '''
    title_is_baidu = EC.title_is(u'百度一下，你就知道')
    self.assertTrue(title_is_baidu(dr))
 
  def test_titile_contains(self):
    ''' 判断title是否包含预期字符 '''
    title_should_contains_baidu = EC.title_contains(u'百度')
    self.assertTrue(title_should_contains_baidu(dr))
 
  def test_presence_of_element_located(self):
    ''' 判断element是否出现在dom树 '''
    locator = (By.ID, search_text_field_id)
    search_text_field_should_present = EC.visibility_of_element_located(locator)
 
    ''' 动态等待10s，如果10s内element加载完成则继续执行下面的代码，否则抛出异常 '''
    WebDriverWait(dr, 10).until(EC.presence_of_element_located(locator))
    WebDriverWait(dr, 10).until(EC.visibility_of_element_located(locator))
 
    self.assertTrue(search_text_field_should_present(dr))
 
  def test_visibility_of(self):
    '''判断元素是否可见'''
    search_text_field = dr.find_element_by_id(search_text_field_id)
    search_text_field_should_visible = EC.visibility_of(search_text_field)
    self.assertTrue(search_text_field_should_visible('yes'))
 
  def test_text_to_be_present_in_element(self):
    '''判断给定文本是否在特定元素中'''
    text_should_present = EC.text_to_be_present_in_element((By.NAME, 'tj_trhao123'), 'hao123')
    self.assertTrue(text_should_present(dr))
 
 
  @classmethod
  def tearDownClass(kls):
    print 'after all test'
    dr.quit()
    print 'quit dr'
 
if __name__ == '__main__':
    pass