UI自动化测试-页面对象设计模式

1、页面对象设计模式的概念（PO模式）：

创建可以跨多个测试用例共享的代码

减少重复代码的数量

如果用户界面发生了维护，我们只需要维护一个地方，这样修改以及维护的成本相对而言是比较低的

2、目录结构设计

 每个目录的简单介绍：

base：基础层，主要编写的是底层元素封装

page：对象层，主要指的是页面的每一个交互写成一个独立的方法

test：测试层，里面主要编写测试用例

common：公共方法，把公共的方法分离到这个里面

utils：工具类，主要指的是操作有一些工具的类

data：把测试过程中的数据存储在这个目录下

report：测试报告，主要指的是存储生成的HTML的测试报告

3、实现基础层的代码，在base包下创建模块为base.py的文件，里面的源码信息为：

from selenium.webdriver.support.expected_conditions import NoSuchElementException

class WebDriver(object):
    def __init__(self,driver):
        # self.driver=webdriver.Chrome()
        # self.driver是driver实例化后的对象
        self.driver=driver

    def findElement(self,*loc):
        '''单个元素定位的方式'''
        try:
            #*loc既表示括号里边是动态参数，也表示括号中的元素是元组类型
            return self.driver.find_element(*loc)
        except NoSuchElementException as e:
            return e.args[0]

    def findElements(self,*loc):
        '''多个元素的定位方式'''
        try:
            return self.driver.find_element(*loc)
        except NoSuchElementException as e:
            return e.args[0]

4、实现对象层的代码，以新浪登录页面为例，在page包下面新建一个login的文件，代码如下：

from selenium.webdriver.common.by import By
from base.base import WebDriver
import time as t

class Login(WebDriver):
    username=(By.ID,'freename')
    password=(By.ID,'freepassword')
    loginButton=(By.LINK_TEXT,'登录')
    userInfo=(By.XPATH,'/html/body/div[3]/div/div[2]/div/div/div[4]/div[1]/div[1]/div[1]/span[1]')
    passwordInfo=(By.XPATH,'/html/body/div[3]/div/div[2]/div/div/div[4]/div[1]/div[1]/div[1]/span[2]')
    emailInfo=(By.XPATH,'//*[@id="user_id"]/em[2]')
    isAutoLogin=(By.ID,'store1')

    def inputUsername(self,username):
        t.sleep(3)
        self.findElement(*self.username).send_keys(username)

    def inputPassword(self,password):
        t.sleep(3)
        self.findElement(*self.password).send_keys(password)

    def clickLogin(self):
        t.sleep(3)
        self.findElement(*self.loginButton).click()

    def getUserDev(self):
        '''获取账户的错误提示信息'''
        t.sleep(3)
        return self.findElement(*self.userInfo).text

    def getPassword(self):
        '''获取密码的错误提示信息'''
        t.sleep(3)
        return self.findElement(*self.passwordInfo).text

    def getEmailInfo(self):
        '''获取登录成功的账户信息'''
        t.sleep(3)
        return self.findElement(*self.emailInfo).text

    def autoLogin(self):
        '''验证自动登录是否勾选'''
        t.sleep(3)
        self.findElement(*self.isAutoLogin).is_selected()

    def autoLoginCancel(self):
        '''验证自动登录是否取消勾选'''
        t.sleep(3)
        self.findElement(*self.isAutoLogin).click()

    def login(self,username,password):
        self.inputUsername(username=username)
        self.inputPassword(password=password)
        self.clickLogin()

5、实现测试层的代码，以新浪登录页面为例，在test包下面新建一个test_login的文件，代码如下：

import unittest
from selenium import webdriver
from page.login import Login
from utils.operationJson import readJson

class TestLogin(unittest.TestCase,Login):
    def setUp(self) -> None:
        self.driver=webdriver.Chrome()
        self.driver.maximize_window()
        self.driver.get("https://mail.sina.com.cn/#")
        self.driver.implicitly_wait(30)

    def tearDown(self) -> None:
        self.driver.quit()

    def test_username_null(self):
        '''登录验证：账户为空错误提示信息验证'''
        self.login(username='',password='')
        self.assertEqual(self.getuserDev(),readJson()['nullEmail'])

    def test_email_format_error(self):
        '''登录验证：验证邮箱格式错误'''
        self.login(username='gfs',password='hhhhf')
        self.assertEqual(self.getuserDev(),readJson()['formatEmail'])

    def test_username_password_error(self):
        '''登录验证：验证登录账户错误'''
        self.login(username='gfhhgh@sina.com',password='xgfj')
        self.assertEqual(self.getuserDev(),readJson()['loginError'])

    def test_password_null(self):
        '''登录验证：验证密码为空错误提示信息'''
        self.login(username='wuya1303@sina.com',password='')
        self.assertEqual(self.getPasswdDev(),readJson()['nullPassword'])

    def test_login_success(self):
        '''登录验证：验证登录成功的账户'''
        self.login(username='wuya1303@sina.com',password='admin123')
        self.assertEqual(self.getEmailDev(),"wuya1303@sina.com")

    def test_auto_login(self):
        '''登录验证：验证自动登录是否勾选'''
        self.assertTrue(self.autoLogin())

    def test_auto_login_cancel(self):
        '''登录验证：验证自动登录是否取消勾选'''
        self.clickAutoLogin()
        self.assertFalse(self.autoLogin())

if __name__ == '__main__':
    unittest.main()

通过主函数入口，运行测试层的代码，得到的结果如下：

 6、公共方法

在common包下创建public.py的模块，并编写针对文件路径的处理，具体源码如下：

import os

def base_dir():
    return os.path.dirname(os.path.dirname(__file__))

def filePath(directory,filename):
    # 获取文件的详细路径
    # directory:目录
    # filename：文件名称
    return os.path.join(base_dir(),directory,filename)

7、数据驱动

在data的文件夹下创建sina.json的文件，把登录使用到的数据分离到sina.json的文件里面，文件内容如下：

{
  "nullEmail":"请输入邮箱名",
  "formatEmail": "您输入的邮箱名格式不正确",
  "loginError":"登录名或密码错误",
  "nullPassword":"请输入密码"
}

8、工具类

在具体的工具类中编写针对JSON文件的处理，创建的模块名称为:operationJson.py，具体源码为：

import unittest
import os
import HTMLTestRunner
from common.public import*
import time

def allTests():
    #获取要执行的测试模块
    suite=unittest.TestLoader().discover(
    #start_dir指的是测试模块的路径
        start_dir=os.path.join(base_dir(),'test'),
    #pattern通过正则方式加载所有测试模块
        pattern="test_*.py")
    return suite

def getNowTime():
    return time.strftime('%y-%m-%d %H_%M_%S',time.localtime(time.time()))

def run():
    filename=os.path.join(os.path.dirname(__file__),'report',getNowTime()+'.html')
    fp=open(filename,"wb")
    runner=HTMLTestRunner.HTMLTestRunner(
        stream=fp,
        title='UI自动化测试',
        description='ui test'
    )
    runner.run(allTests())

if __name__ == '__main__':
    run()

运行代码后的结果如下：

 9、新浪首页注册实战

1）对象层代码如下：

from selenium.webdriver.common.by import By
import time as t
from base.base import WebDriver

class Register(WebDriver):
    register=(By.CLASS_NAME,'registerBtn')
    agree=(By.NAME,'agreement')
    register_right_away=(By.XPATH,'/html/body/div[2]/div/div/div/div/form[1]/div[3]/ul/li/div/div/a')
    email_null=(By.XPATH,'/html/body/div[2]/div/div/div/div/form[1]/div[2]/ul/li[1]/div[3]/p/abbr')

    def clickRegister(self):
        t.sleep(3)
        self.findElement(*self.register).click()

    def clickAgree(self):
        t.sleep(3)
        self.findElement(*self.agree).click()

    def clickRegisterAway(self):
        t.sleep(3)
        self.findElement(*self.register_right_away).click()

    def clickReg(self):
        self.clickAgree()
        self.clickRegisterAway()

    def getEmail(self):
        t.sleep(3)
        return self.findElement(*self.email_null).text

2）测试层代码如下：

from selenium import webdriver
from page.register import Register
from utils.operationJson import readJson
import unittest
import time as t
class TestRegister(unittest.TestCase,Register):
    def setUp(self) -> None:
        self.driver=webdriver.Chrome()
        self.driver.maximize_window()
        self.driver.get('https://mail.sina.com.cn/#')
        self.driver.implicitly_wait(30)

    def tearDown(self) -> None:
        self.driver.quit()

    def test_email_null(self):
        '''注册验证：邮箱为空错误提示信息验证'''
        nowHandler=self.driver.current_window_handle
        self.clickRegister()
        t.sleep(3)
        allHandlers=self.driver.window_handles
        t.sleep(3)
        for handler in allHandlers:
            if handler!=nowHandler:
                self.driver.switch_to.window(handler)
                self.clickReg()
        self.assertEqual(self.getEmail(),readJson()['nullEmail'])

if __name__ == '__main__':
    unittest.main()

运行测试层代码后的结果如下：