PO

PO：Page Object，po是一种设计模式，提供通用的方法，简单来说就是分层设计。

• 官方文档：https://martinfowler.com/bliki/PageObject.html

• PO在Selenium中的应用，官方文档：https://www.selenium.dev/documentation/test_practices/encouraged/page_object_models/

场景：我们最初做UI自动化测试时，一个python文件可以实现整个流程的操作，那么会带来的问题有：

• 代码可读性差，一旦有一个元素的位置发生改动，改起来特别费劲；
• 代码维护性差，时间久了看不懂，别人也看不懂；
• 可扩展性弱，比如登录，这个页面需要登录，到了另外一个页面可能还需要登录，需要再写一遍。

要解决这种问题，我们需要把场景抽象化，通过PO思想进行封装。把操作细节封装成方法，对外只提供方法，不提供细节。当需要修改时只改操作细节，不改对外暴露的方法。但是，不是所有页面都封装，只封装主要模块，不封装次要模块。

截图.png

PO原则

• 用一个方法代替页面的服务
• 对外提供的方法不暴露细节
• 对外提供的方法中不包含断言
• 如果页面a导航到页面b，page a应该return page b
• 不为页面的所有元素封装方法
• 当出现正确的和错误的结果时，我们封装时要分开写，不要揉到一起写

举个例子，以企业微信后台为例，先构思一下用例：

image.png

用PO思想，我需要创建几个文件：

• main_page.py：主页的po，提供主页的方法，不提供细节
• base_page.py：抽离通用方法的po
• add_member_page.py：添加成员页po，继承base_page，对应具体添加成员的操作细节
• contact_page.py：通讯录页的po，继承base_page，对应具体通讯录的操作细节
• test_add_member.py：添加成员的测试用例及断言

main_page.py

from time import sleep
from selenium import webdriver
from selenium.webdriver.common.by import By
from test_selenium.work_weixin.api.add_member_page import AddMemberPage
from test_selenium.work_weixin.api.base_page import BasePage
from test_selenium.work_weixin.api.contact_page import ContactPage

class MainPage(BasePage):
    """
    首页
    """
    _base_url = 'https://work.weixin.qq.com/wework_admin/frame#index'
    def goto_contact(self):
        """
        跳转通讯录页面
        :return:
        """
        return ContactPage()

    def goto_add_member(self):
        """
        跳转添加成员页面
        :return:
        """
        self.driver.find_element(By.XPATH, '//*[@id="_hmt_click"]/div[1]/div[4]/div[2]/a[1]/div/span[2]').click()
        sleep(1)
        return AddMemberPage(self.driver)

base_page.py

from time import sleep
import yaml
from selenium import webdriver
from selenium.webdriver.chrome.webdriver import WebDriver
from selenium.webdriver.opera.options import Options

class BasePage:
    """
    封装所有页面对象通用的操作，如driver的实例化
    """
    _base_url = None
    def __init__(self, base_driver=None):
        """
        子类没有构造函数，在实例化过程中会自动调用父类的构造函数，所以每个PO在实例化过程中都会执行构造函数的逻辑，这样就会初始化多个driver
        所以需要避免driver的重复实例化
        """
        # 如果base_driver为真,就不需要重复driver实例化操作
        if base_driver:
            self.driver =base_driver
        # 如果base_driver为None，就需要对driver实例化
        else:
            # 不加self是局部变量
            self.driver = webdriver.Chrome()
            self.driver.implicitly_wait(5)
            # url优化
            if self._base_url != None:
                self.driver.get(self._base_url)
                cookie = yaml.safe_load(open('../data/login_cookie.yml'))
                print(cookie)
                # 种cookie
                for c in cookie:
                    self.driver.add_cookie(c)
                sleep(2)
                self.driver.get(self._base_url)

    def find(self, by, locaotor):
        """
        封装find_element操作
        :param by:
        :param locaotor:
        :return:
        """
        res = self.driver.find_element(by, locaotor)
        print(f"找到的元素为{res}")
        return res

add_member_page.py

from time import sleep
from selenium.webdriver.chrome.webdriver import WebDriver
from selenium.webdriver.common.by import By
from test_selenium.work_weixin.api.base_page import BasePage
from test_selenium.work_weixin.api.contact_page import ContactPage

class AddMemberPage(BasePage):
    """
    添加成员页
    """
    _base_url = 'https://work.weixin.qq.com/wework_admin/frame#contacts'

    def goto_contact(self):
        """
        跳转通讯录页面
        :return:
        """
        return ContactPage()

    def add_member(self, username, acctid, phonenum):
        """
        添加成员操作
        :return:
        """
        self.find(By.ID, 'username').send_keys(username)
        self.find(By.ID, 'memberAdd_acctid').send_keys(acctid)
        self.find(By.ID, 'memberAdd_phone').send_keys(phonenum)
        self.driver.find_element(By.CSS_SELECTOR, '.js_btn_save').click()
        return ContactPage(self.driver)

    def add_member_fail(self):
        """
        添加成员操作
        :return:
        """
        self.find(By.ID, 'username').send_keys('')
        self.find(By.ID, 'memberAdd_acctid').send_keys('111')
        self.find(By.ID, 'memberAdd_phone').send_keys('13600001243')
        error_list = self.driver.find_elements(By.CSS_SELECTOR, '.ww_inputWithTips_tips')
        print(error_list)

        # 寻找所有的错误信息，如果不为空，则返回
        err_message = [ele.text for ele in error_list if ele.text != ""]
        return err_message
        return ContactPage(self.driver)

contact_page.py

from test_selenium.work_weixin.api.base_page import BasePage
class ContactPage(BasePage):
    """
    通讯录列表页
    """
    _base_url = 'https://work.weixin.qq.com/wework_admin/frame#contacts'

    def goto_add_member(self):
        """
        添加成员
        :return:
        """
        # 如果出现A到B，B到A循环导入的场景，需要把其中一个的导包放在方法里
        from test_selenium.work_weixin.api.add_member_page import AddMemberPage

        return AddMemberPage()

    def member_list(self, member_name):
        """
        成员列表list
        :return:
        """
        return ['member_name']

test_add_member.py

from test_selenium.work_weixin.api.add_member_page import AddMemberPage
from test_selenium.work_weixin.api.contact_page import ContactPage
from test_selenium.work_weixin.api.main_page import MainPage

class TestAddMember:
    """
    添加成员的测试用例
    """
    def setup_class(self):
        """
        页面实例化MainPage
        :return:
        """
        self.main = MainPage()

    def test_add_member(self):
        """
        1.在首页，点击添加成员按钮，跳转到添加成员页面
        2.在添加成员页面，填写成员信息，点击保存
        3.在通讯录页面查看信息是否添加成功

        :return:
        """
        # # 方法一
        # # 页面实例化，调用过于复杂
        # main = MainPage()
        # add_member_page = AddMemberPage()
        # contact_page = ContactPage()
        #
        # # 1.在首页，点击添加成员按钮，跳转到添加成员页面
        # main.goto_add_member()
        #
        # # 2在添加成员页面，填写成员信息，点击保存
        # add_member_page.add_member()
        #
        # # 3.在通讯录页面查看成员是否添加成功
        # contact_page.member_list()

        # 方法二
        username, acctid, phonenum = "吱吱3", '3', '18700001234'

        # 通过前面return实例对象，可以直接用方法.方法的方式，实现链式调用
        res = self.main.goto_add_member().add_member(username, acctid, phonenum).member_list('member_name')

        # 断言与手工测试一致，断言添加的成员是否在结果中，如果在表示用例通过，否则失败
        assert 'member_name' in res

    def test_add_member_fail(self):
        """
        反向用例，成员名称为空
        :return:
        """
        error_list = self.main.goto_add_member().add_member_fail()
        assert "请填写姓名" in error_list

    def teardown_class(self):
        self.main.driver.quit()

源码彩蛋》》》
链接: https://pan.baidu.com/s/14p0Q38whTbjlRwlMZA-iVg
提取码: 7wzh