Webium简明教程 on 重定向学院

1. webium简介及安装

Sun, 29 Oct 2017 06:55:26 +0800

webium是基于python的一个Page Object实现, API简单友好，可以在一定程度上提升Web UI测试的生产力，值得我们进行学习。

不过注意: webium要配合selenium一起使用。

用有的链接

安装

pip install webium

常用类

一般来说我们会经常用到下面几个类

webium.Find: 在page中定位单个元素
webium.Finds: 在page中定位一组元素
webium.BasePage: 页面的基类，其他页面都必须是该类的子类

使用方式

下面以百度搜索重定向科技为例

# baidu.py
from selenium import webdriver
from selenium.webdriver.common.by import By
from webium import BasePage, Find, Finds
import time

class BaiduPage(BasePage):
 url = 'https://www.baidu.com'

 keyword = Find(by=By.ID, value='kw')
 button = Find(by=By.ID, value='su')

class ResultsPage(BasePage):
 first_result = Find(by=By.CSS_SELECTOR, value='.result')

if __name__ == '__main__':
 dr = webdriver.Chrome()

 baidu_page = BaiduPage(driver=dr)
 baidu_page.open()

 baidu_page.keyword.send_keys('重定向科技')
 baidu_page.button.click()
 time.sleep(3)

 results_page = ResultsPage(driver=dr)
 print(results_page.first_result.text)

 dr.quit()

运行及结果

python baidu.py

重定向科技
重定向科技(www.itest.info)致力于培养中国软件测试行业中高端人才,公司长年专注于软件测试教育领域,拥有先进的软件测试教育体系,向个人和企业客户提供领先的软件测试...
itest.info/ - 百度快照

原始封面

2. BasePage

Sat, 28 Oct 2017 06:55:26 +0800

页面类是Page Object设计模式的核心。在使用webium创建页面类的时候，必须继承webium.base_page.BasePage

from webium import BasePage

class MyPage(BasePage):
 pass

url

如果页面的url是固定的，那么可以在__init__方法中指定它，然后你就可以使用open()方法来跳转到该页面。

url也可以被定义成是类的静态属性。

from webium import BasePage

class PageWithUrl(BasePage):
 def __init__(self):
 super(PageWithUrl, self).__init__(url='http://www.testclass.net/')

class AnotherPageWithUrl(BasePage):
 url = 'http://www.itest.info'

if __name__ == '__main__':
 page = PageWithUrl()
 page.open()

 itest = AnotherPageWithUrl()
 itest.open()

driver

页面类必须持有WebDriver的实例以便操控浏览器。默认情况下，webium会使用webium.settings.driver_class来创建WebDriver实例。如果你需要获取driver的实例，你可以使用webium.driver.get_driver()来达到目的。

在实例化页面类时，我们也可以通过driver参数来显示传入WebDriver实例。

from selenium.webdriver import Firefox
from webium import BasePage

class DriverHandlingPage(BasePage):
 def __init__(self, *args, **kwargs):
 super(DriverHandlingPage, self).__init__(url='http://testclass.net/', *args, **kwargs)


if __name__ == '__main__':
 my_driver = Firefox()
 page = DriverHandlingPage(driver=my_driver)
 page.open()
 print('Page title: ' + my_driver.title)
 my_driver.quit()

原始封面

3. Find

Fri, 27 Oct 2017 06:55:26 +0800

webium.find.Find 方法可以在页面或者其他容器中定位元素，返回WebElement实例。

Find方法的主要用到2个参数分别是

by: 定位策略，比如By.ID
value: 定位元素时用到的具体属性值

from selenium.webdriver.common.by import By
from webium import BasePage, Find

class SomePage(BasePage):
 buy_btn = Find(by=By.CSS_SELECTOR, value='a.buy-btn')

 def __init__(self):
 super(SomePage, self).__init__(url='http://itest.info')


if __name__ == '__main__':
 page = SomePage()
 page.open()
 page.buy_btn.click()

ui_type

在定位一些自定义的对象时我们可以指定ui_type参数来定制化Find的行为。

from selenium.webdriver.common.by import By
from selenium.webdriver.remote.webelement import WebElement
from webium import BasePage, Find

class Link(WebElement):
 def is_secure(self):
 return self.get_attribute('href').startswith('https://')


class TypedPage(BasePage):
 join_link = Find(Link, By.CSS_SELECTOR, 'a.hover-effect')

 def __init__(self):
 super(TypedPage, self).__init__(url='http://itest.info')


if __name__ == '__main__':
 page = TypedPage()
 page.open()
 print('Is link secure: ' + str(page.join_link.is_secure()))

上面的例子里，我们定义了Link类，继承自WebElement，用以代表一般性的链接。is_secure()方法用来判断链接是否是https协议的。

join_link = Find(Link, By.CSS_SELECTOR, 'a.hover-effect')表示定位元素，并返回类型是Link的实例。

context 上下文

有时候你可能在用例运行时才可以确定页面的结构，现代网页是动态且多变的。如果你不能在类属性的定义中使用Find，那么你应该直接把该页面对象直接传到定位代码里。

from selenium.webdriver.common.by import By
from webium import BasePage, Find

class DynamicPage(BasePage):
 def __init__(self):
 super(DynamicPage, self).__init__(url='http://itest.info')

 def get_link_by_href(self, href):
 return Find(by=By.CSS_SELECTOR, value='a[href*="{0}"]'.format(href), context=self)


if __name__ == '__main__':
 page = DynamicPage()
 page.open()
 page.get_link_by_href('registration').click()

上面的例子里, get_link_by_href(self, href)方法通过动态传入的href来定为不同的对象，这时候就需要把self传入Find的对应上下文里，这是套路，因为Find方法就是这么设计以便正常工作的。

4. Finds

Thu, 26 Oct 2017 06:55:26 +0800

webium.find.Finds 方法的用法跟Find方法基本是一致的，不过返回的是WebElement列表。

from selenium.webdriver.common.by import By
from webium import BasePage, Finds

class LinksPage(BasePage):
 links = Finds(by=By.TAG_NAME, value='a')

 def __init__(self):
 super(LinksPage, self).__init__(url='http://itest.info')


if __name__ == '__main__':
 page = LinksPage()
 page.open()
 print('Number of links: ' + str(len(page.links)))

我们甚至可以动态返回满足条件的一组元素。

from selenium.webdriver.common.by import By
from selenium.webdriver.remote.webelement import WebElement
from webium import BasePage, Finds


class Link(WebElement):
 def is_secure(self):
 return self.get_attribute('href').startswith('https://')


class TypedPage(BasePage):
 links = Finds(Link, By.TAG_NAME, 'a')

 def __init__(self):
 super(TypedPage, self).__init__(url='http://itest.info')

 def get_unsecured_links(self):
 return filter(lambda link: not link.is_secure(), self.links)


if __name__ == '__main__':
 page = TypedPage()
 page.open()
 print('Number of unsecured links: ' + str(len(page.get_unsecured_links())))

原始封面

5. Containers

Wed, 25 Oct 2017 06:55:26 +0800

我们可以使用容器(containers)来限制定位范围，webium的containers特性可以让我们的定位代码更加干净容易理解，避免大规模的使用难懂晦涩的xpath。

考虑下面的页面结构，为了可以遍历每一个搜索结果，我们可以使用下面的代码

from selenium.webdriver.common.by import By
from selenium.webdriver.remote.webelement import WebElement
from webium import Find, Finds, BasePage

class Vacancy(WebElement):
 title = Find(by=By.CLASS_NAME, value='vacancy_title')
 profession = Find(by=By.CLASS_NAME, value='vacancy_profession')
 location = Find(by=By.CLASS_NAME, value='vacancy_location')
 apply_button = Find(by=By.CLASS_NAME, value='vacancy_apply_button')


class VacanciesPage(BasePage):
 vacancies_list = Finds(Vacancy, By.XPATH, '//div[@id="careers-vacancies"]/div[@data-id]')

 def __init__(self):
 super(VacanciesPage, self).__init__(url='http://wargaming.com/en/careers/vacancies/')


if __name__ == '__main__':
 page = VacanciesPage()
 page.open()
 for vacancy in page.vacancies_list:
 # search by CLASS_NAME='vacancy_title' is performed within one node
 print('Title: ' + vacancy.title.text)

原始封面

6. Logical Containers

Tue, 24 Oct 2017 06:55:26 +0800

逻辑容器适用于这样的场景：页面上有一些元素确实存在于容器中，但这些元素都有可以唯一能够定位的属性，比如id等，而我们为了代码的可读性，往往希望将这些元素放在某个容器中。

比如页面上的菜单元素，每个子菜单都有id属性，不过为了代码能够更好的被他人理解，我们希望将子菜单放到菜单容器里。

逻辑容器和普通容器的区别：

普通容器需要继承自WebElement，而逻辑容器不需要
定义逻辑容器时Find方法不需要by和value参数

from selenium.webdriver.common.by import By
from webium import Find, BasePage


class Nav(object):
 class_info = Find(by=By.CSS_SELECTOR, value='a[href*="/newclass"]')
 faq = Find(by=By.CSS_SELECTOR, value='a[href*="/faq"]')


class ItestPage(BasePage):
 # here we are just grouping Header elements together without any influence on actual search
 nav = Find(Nav)

 def __init__(self):
 super(StructuredPage, self).__init__(url='http://itest.info')


if __name__ == '__main__':
 page = ItestPage()
 page.open()
 print(page.menu.class_info.text)
 print(page.menu.faq.text)

原始封面

7. 判断元素是否存在

Tue, 24 Oct 2017 06:55:26 +0800

is_element_present

判断元素是否存在。所有的容器类(BasePage, Container和Logical Container)都有is_element_present方法，如果对应名称的元素在页面上存在，该方法返回true。

from selenium.webdriver.common.by import By
from webium import BasePage, Find

class PresencePage(BasePage):
 class_info = Find(by=By.CSS_SELECTOR, value='a[href*="/newclass"]')
 faq = Find(by=By.CSS_SELECTOR, value='a[href*="/faq"]')

 def __init__(self):
 super(PresencePage, self).__init__(url='http://itest.info')


if __name__ == '__main__':
 page = PresencePage()
 page.open()
 print('This should be True: ' + str(page.is_element_present('class_info')))
 print('This should be False: ' + str(page.is_element_present('no_such_link')))

注意：如果是通过Finds去定位的一组元素，我们也可以调用is_element_present方法来判断这组元素的存在性。如果这一组元素全部存在，返回True,如果有任意1个元素不存在，返回False。

just_in_dom

默认情况下，is_element_prasent方法只有在这个元素可见的时候返回True。如果我们需要元素存在于dom中就返回True的话，那么设置just_in_dom=True

timeout

timeout是等待is_element_prasent返回True的时间，单位是秒。

print('This should be True: ' + str(page.is_element_present('class_info', just_in_dom=True, timeout=3)))

原始封面

8. 其他

Mon, 23 Oct 2017 06:55:26 +0800

wait

webium.wait.wait()是python wait库的简单封装。

具体实现看这里

settings

可以看成是webium的全局配置，有下面的一些配置项目，具体看这里

driver_class = Firefox # 默认的driver
implicit_timeout = 30 # 默认的隐式等待时间
wait_timeout = 30 # 等待超时时间

default_search_type = By.ID # 默认的定位策略

具体例子

import webium.settings
from selenium.webdriver import Chrome

webium.settings.implicit_timeout = 0
webium.settings.driver_class = Chrome

原始封面