poium測試庫介紹

poium測試庫前身爲selenium-page-objects測試庫,我在之前的文章中也有介紹過:這多是最簡單的Page Object庫,項目的核心是基於Page Objects實現元素定位的封裝。該項目由我我的在維護,目前在公司項目中已經獲得的應用。javascript


poium的優點

Page Objects設計模式你們都懂,以往咱們對Page層的封裝大概是這樣的。css

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):
       return self.by_id("kw")

   # 搜索按鈕
   @property
   def search_button(self):
       return self.by_id("su")

大致上是每一個操做元素封裝爲一個方法,這樣並沒什麼很差的,只是不夠簡潔。而poium能夠極大的簡化元素的定義,甚至接近,配置文件。html

from poium import Page, PageElement

class BaiduIndexPage(Page):
    search_input= PageElement(css="#kw", describe="搜索框")
    search_button= PageElement(css="#su", describe="搜索按鈕")

幾百個元素的也只不過幾百行代碼,使用也遠比配置文件簡單。將元素寫到配置文件裏,你還要考慮如何讀取。java

無論是前一種page層封裝,仍是使用poium封裝在測試用例中的使用並沒有太大的差異。python

from selenium import webdriver
import unittest

defbaiduTest(unittest.TestCase):
 
    defsetUp(self):
        self.driver =webdriver.Chrome()
        self.base_url ="https://www.baidu.com"
    
    def tearDown(self):
        self.driver.quit()
    
    def test_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能夠更輕鬆的處理彈窗。android

因而,我封裝了一組由JS實現的API。ios

from poium import Page

class BaiduPage(Page):
    # 元素定位只支持CSS語法
    search_input ="#kw"
    search_button ="#su"

def test_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定位。git

強列推薦使用CSS定位,由於poium還能夠將操做過的元素在自動化的運行過程當中給你標記出來。github

這樣當程序運行失敗須要截圖時就比較清晰了,可是,這個功能還不完善。web


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
相關文章
相關標籤/搜索