简介
Page Object Model：页面对象模型，是Selenium中的一种测试设计模式，一个页面对象代表用户界面交互测试的一个区域。
使用page object来实现：测试、逻辑、数据、驱动相互分离。
使用页面对象模式的好处:
- 创建可重用的代码,可以跨多个测试用例共享
- 减少重复代码的数量
- 如果用户界面更改,只需要修改一个地方
基类
每个页面类继承。该类封装了下级page类的基本功能和公共的功能。
from selenium.webdriver.support.ui import WebDriverWait
class BasePageElement(object):
"""Base page class that is initialized on every page object class."""
def __set__(self, obj, value):
"""Sets the text to the value supplied"""
driver = obj.driver
WebDriverWait(driver, 100).until(
lambda driver: driver.find_element_by_name(self.locator))
driver.find_element_by_name(self.locator).send_keys(value)
def __get__(self, obj, owner):
"""Gets the text of the specified object"""
driver = obj.driver
WebDriverWait(driver, 100).until(
lambda driver: driver.find_element_by_name(self.locator))
element = driver.find_element_by_name(self.locator)
return element.get_attribute("value")
各页面对象
页面对象模式将为每个web页面创建一个对象。封装一些各页面的方法。
page.py如下：
from element import BasePageElement
from locators import MainPageLocators
class SearchTextElement(BasePageElement):
"""这个类从指定的定位器中获得搜索文本"""
#The locator for search box where search string is entered
locator = 'q'
class BasePage(object):
"""Base class to initialize the base page that will be called from all pages"""
def __init__(self, driver):
"""该driver是测试用例使用时传过来的"""
self.driver = driver
class MainPage(BasePage):
"""Home page action methods come here. I.e. Python.org"""
#Declares a variable that will contain the retrieved text
search_text_element = SearchTextElement()
def is_title_matches(self):
"""验证"Python"字符串在title中"""
return "Python" in self.driver.title
def click_go_button(self):
"""触发搜索"""
element = self.driver.find_element(*MainPageLocators.GO_BUTTON)
element.click()
class SearchResultsPage(BasePage):
"""Search results page action methods come here"""
def is_results_found(self):
# Probably should search for this text in the specific page
# element, but as for now it works fine
return "No results found." not in self.driver.page_source
测试基础类
封装setup 和 teardown的类。这里用appium的例子。
class BaseTest(unittest.TestCase):
def setUp(self):
path = lambda p: os.path.abspath(
os.path.join(os.path.dirname(__file__), p)
)
desired_caps = {
"platformName": "Android",
"platformVersion": "5.0.1",
"deviceName": "MX5",
"appPackage": "net.xxx.debug",
"appActivity": "net.xxx.MainActivity",
"unicodeKeyboard": "True",
"resetKeyboard": "True",
"app": path("./apps/debug.10.apk")
}
self.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
def tearDown(self):
self.driver.quit()
测试代码
具体的测试用例写在这里。
import unittest
from selenium import webdriver
import page
class PythonOrgSearch(BaseTest):
def setUp(self):
self.driver = webdriver.Firefox()
self.driver.get("http://www.python.org")
def test_search_in_python_org(self):
"""
验证查找的元素存在
"""
#加载main page.这里使用Python.org.
main_page = page.MainPage(self.driver)
#检验“python”在title中
assert main_page.is_title_matches(), "python.org title doesn't match."
#设置搜索模式 "pycon"
main_page.search_text_element = "pycon"
main_page.click_go_button()
search_results_page = page.SearchResultsPage(self.driver)
#验证搜索结果页不为空
assert search_results_page.is_results_found(), "No results found."
def tearDown(self):
self.driver.close()
if __name__ == "__main__":
unittest.main()
定位器
定位器将定位的字符串和使用它们的地方分隔开来，将来开发修改了定位的方式和字符串只用来改该文件。
locators.py如下：
from selenium.webdriver.common.by import By
class MainPageLocators(object):
"""主页的定位器们"""
GO_BUTTON = (By.ID, 'submit')
class SearchResultsPageLocators(object):
"""搜索结果页定位器们"""
pass
要将全部定位器放在同一个module中，应该定位器中也有很多公用的部分。
这里使用类，方便refactor，多个页面有相同的class或者是xpath的时候，是放在公用的定位器中还是单独的页面定位器中呢？
如果页面时公用的部分，如loading，title等则放在公用的定位器中，否则放在单独的页面定位器中。这就要求对前端的设计有一些大概的了解，如果没有把握的话最好放在单独的页面定位器中。
菜单的定位器集中放在common.py中，不放在每个页面中，菜单不属于各个页面。
添加注释
会显示在报告中
class AddAccount(Login):
"""添加账号"""
def setUp(self):
super(AddAccount, self).setUp()
写在class下面，不要写在setup下面。
添加类注释
## 添加测试用例注释
```python
def test_search_in_python_org(self):
"""
验证查找的元素存在
"""