poium测试库前身为selenium-page-objects测试库,我在以前的文章中也有介绍过:这可能是最简单的Page Object库,项目的核心是基于Page Objects实现元素定位的封装。该项目由我个人在维护,目前在公司项目中已经得到的应用。
poium的优势
Page Objects设计模式大家都懂,以往我们对Page层的封装大概是这样的。
class BasePage():
def __init__(self, driver):
self.dr =driver
def by_id(self, elem):
returnself.dr.find_element_by_id(elem)
class BaiduIndexPage(BasePage):
# 搜索框
@property
def search_input(self):
returnself.by_id("kw")
# 搜索按钮
@property
def search_button(self):
returnself.by_id("su")
大体上是每个操作元素封装为一个方法,这样并没什么不好的,只是不够简洁。而poium可以极大的简化元素的定义,甚至接近,配置文件。
from poium import Page, PageElement
class BaiduIndexPage(Page):
search_input= PageElement(css="#kw", describe="搜索框")
search_button= PageElement(css="#su", describe="搜索按钮")
几百个元素的也只不过几百行代码,使用也远比配置文件简单。将元素写到配置文件里,你还要考虑如何读取。
不管是前一种page层封装,还是使用poium封装在测试用例中的使用并无太大的差别。
from selenium import webdriver
import unittest
defbaiduTest(unittest.TestCase):
defsetUp(self):
self.driver =webdriver.Chrome()
self.base_url ="https://www.baidu.com"
deftearDown(self):
self.driver.quit()
deftest_search(self):
page= BaiduIndexPage(driver)
page.get(self.base_url)
page.search_input.send_keys("poium")
page.search_button.click()
# .....
JavaScript API
在我们项目中,时常要用到JavaScript操作,比如日期控件不好操作,那会通过JS的removeAttribute() 删除掉元素的某些属性,使他可以通过输入完成日期的“选择”。比如,有些元素用Selenium点击不了,但JS的click()却可以,再比如有些弹窗不是必现的,就必须使用异常捕捉,但JS可以更轻松的处理弹窗。
于是,我封装了一组由JS实现的API。
from poium import Page
class BaiduPage(Page):
# 元素定位只支持CSS语法
search_input ="#kw"
search_button ="#su"
deftest_attribute(self):
"""
元素属性修改/获取/删除
:param browser: 浏览器驱动
"""
driver= webdriver.Chrome()
page =BaiduPage(browser)
page.get("https://www.baidu.com")
page.remove_attribute(page.search_input,"name")
page.set_attribute(page.search_input, "type", "password")
value =page.get_attribute(page.search_input, "type")
assert value =="password"
不过,JS实现的API中的只支持CSS定位。
强列推荐使用CSS定位,因为poium还可以将操作过的元素在自动化的运行过程中给你标记出来。
这样当程序运行失败需要截图时就比较清晰了,但是,这个功能还不完善。
appium 支持
为什么不是不叫selenium-page-objects了?因为poium也支持appium了呀,使用之前的名字如何表达对appium的支持呢?
from appium import webdriver
from poium import Page,PageElement
class CalculatorPage(Page):
number_1 = PageElement(id_="com.android.calculator2:id/digit_1")
number_2 = PageElement(id_="com.android.calculator2:id/digit_2")
add = PageElement(id_="com.android.calculator2:id/op_add")
eq = PageElement(id_="com.android.calculator2:id/eq")
# APP定义运行环境
desired_caps = {
'deviceName': 'AndroidEmulator',
'automationName': 'appium',
'platformName': 'Android',
'platformVersion': '7.0',
'appPackage': 'com.android.calculator2',
'appActivity': '.Calculator',
}
driver =webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
page =CalculatorPage(driver)
page.number_1.click()
page.add.click()
page.number_2.click()
page.eq.click()
driver.quit()
在appium中的使用与selenium是一致的!当然,appium扩展了更多的定位方法。
- ios_uiautomation
- ios_predicate
- ios_class_chain
- android_uiautomator
- android_viewtag
- android_datamatcher
- accessibility_id
- image
- custom
poium同样支持这些定位,在appium中如何使用,那么这里也是一样的。
最后,poium并不会对你的现有自动化产生太多的影响,它只是对元素操作的封装,你可以在项目当中随意的选择是否要用它。
项目地址:poium
支持pip安装:
pip install poium
原文地址:https://www.cnblogs.com/fnng/p/10739141.html