如何在 Selenium 中进行断言

Posted on Wed, 25 Dec 2024 16:13:34 +0800 by LiangMingJian


概述

Expected Conditions 是 Selenium 提供的断言工具,通常使用场景有以下的 2 种。

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

使用

dr = webdriver.Chrome()
url = 'https://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__':
  unittest.main()

可用方法

序号函数名描述返回值
1title_is判断当前页面的 title 是否精确等于预期布尔
2title_contains判断当前页面的 title 是否包含预期字符串布尔
3presence_of_element_located判断元素是否被加到了 DOM 树里,并不代表该元素一定可见WebElement
4visibility_of_element_located判断元素是否被加到了 DOM 树里,并且可见,并且元素的宽和高都不等于 0WebElement
5visibility_of判断元素是否可见,如果可见则返回这个元素WebElement
6presence_of_all_elements_located判断是否至少有 1 个元素存在于 DOM 树中列表
7visibility_of_any_elements_located判断是否至少有 1 个元素在页面上可见列表
8text_to_be_present_in_element判断元素的 text 是否包含了预期的字符串布尔
9text_to_be_present_in_element_value判断元素的 value 是否包含了预期的字符串布尔
10frame_to_be_available_and_switch_to_it判断该 frame 是否可以切换进去布尔
11invisibility_of_element_located判断某个元素中是否不存在于 DOM 树或不可见布尔
12element_to_be_clickable判断某个元素中是否可见并且是 enable 可操作的布尔
13staleness_of判断某个元素是否从 DOM 树中移除布尔
14element_to_be_selected判断某个元素是否被选中了,一般用在下拉列表布尔
15element_selection_state_to_be判断某个元素的选中状态是否符合预期布尔
16element_located_selection_state_to_be判断某个元素的选中状态是否符合预期布尔
17alert_is_present判断页面上是否存在 alert布尔
参考文件 1: selenium expected conditions 使用实例 @乙醇