playwright自动化项目搭建

• 📢专注于分享软件测试干货内容，欢迎点赞 👍 收藏 ⭐留言 📝 如有错误敬请指正！
• 📢交流讨论：欢迎加入我们一起学习！
• 📢资源分享：耗时200+小时精选的「软件测试」资料包
• 📢 最困难的时候，也就是我们离成功不远的时候！

---

这是关于playwright系列介绍的最后一篇。搭建基于 playwright 的自动化项目。

具备功能

关键技术：

• pylaywright测试库
• pytest单元测试框架
• pytest-playwright插件

非关键技术：

• pytest-html插件
• pytest-rerunfailures插件
• seldom 测试框架

实现功能：

• 元素定位与操作分离
• 失败自动截图并保存到HTML报告
• 失败重跑
• 可配置不同的浏览器执行
• 可配置headless/headful 模式
• 实现参数化读取数据文件

一个自动化具备的基本功能差不多就这些了。其实主要是使用了一堆框架和插件，主要是整合能力。

使用方式

安装依赖

$ pip install -r requirements.txt
1

注：安装requirements.txt指定依赖库的版本，这是经过测试的，有时候新的版本可会有错。

• 配置

在 config.py 文件配置

class RunConfig:
    """
    运行测试配置
    """
    # 运行测试用例的目录或文件
    cases_path = "./test_dir/test_parametrize.py"

    # 配置浏览器驱动类型(chromium, firefox, webkit)。
    browser = "chromium"

    # 运行模式（headless, headful）
    mode = "headful"

    # 配置运行的 URL
    url = "https://www.baidu.com"

    # 失败重跑次数
    rerun = "0"

    # 当达到最大失败数，停止执行
    max_fail = "5"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

运行
运行测试

$ python run.py
1

设计细节

关于page object设计模式
page object是自动化测试最常用的设计模式。

但 playwright 中的只提供了操作方法，元素定位和测试数据都只是参数。

# 输入
page.type('#kw', "playwright")
# 点击
page.click('#su')

1
2
3
4
5

我们依然，可以将元素定位单独封装一层。

class BaiduElem:
    search_input = "#kw"  # 搜索框
    search_button = "#su"  # 搜索按钮
    settings = "#s-usersetting-top"  # 设置
    search_setting = "#s-user-setting-menu > div > a.setpref"  # 搜索设置
    save_setting = 'text="保存设置"'  # 保存设置

1
2
3
4
5
6
7

在测试用例中的使用

from element.baidu_element import BaiduElem
from playwright.sync_api import Page


def test_baidu_search(page: Page, base_url):
    """
    """
    page.goto(base_url)
    page.type(BaiduElem.search_input, text="playwright")
    page.click(BaiduElem.search_button)
    sleep(2)
    assert page.title() == "playwright_百度搜索"

1
2
3
4
5
6
7
8
9
10
11
12
13

这肯定不是什么好的设计。用例层写起来会比较啰嗦， 最好可以page.elem.type(“playwright”) 的语法实现，这就需要在playwright的基础上再封装一套API, 看playwright 源码还是有些复杂的，主要是用了很多就异步，成本比较大，暂时先这么用。

关于自动截图
自动截图需要 pytest/pytest-html 和 playwright 配合完成， pytest/pytest-html 判断用例实现，并把图片插入到报告中。 playwright 实现截图动作。

@pytest.mark.hookwrapper
def pytest_runtest_makereport(item):
    """
    用于向测试用例中添加用例的开始时间、内部注释，和失败截图等.
    :param item:
    """
    pytest_html = item.config.pluginmanager.getplugin('html')
    outcome = yield
    report = outcome.get_result()
    report.description = description_html(item.function.__doc__)
    extra = getattr(report, 'extra', [])
    page = item.funcargs["page"]
    if report.when == 'call':
        xfail = hasattr(report, 'wasxfail')
        if (report.skipped and xfail) or (report.failed and not xfail):
            case_path = report.nodeid.replace("::", "_") + ".png"
            if "[" in case_path:
                case_name = case_path.split("-")[0] + "].png"
            else:
                case_name = case_path

            capture_screenshots(case_name, page)
            img_path = "image/" + case_name.split("/")[-1]
            if img_path:
                html = '
' % img_path
                extra.append(pytest_html.extras.html(html))
        report.extra = extra

def capture_screenshots(case_name, page):
    """
    配置用例失败截图路径
    :param case_name: 用例名
    :return:
    """
    global driver
    file_name = case_name.split("/")[-1]
    if RunConfig.NEW_REPORT is None:
        raise NameError('没有初始化测试报告目录')
    else:
        image_dir = os.path.join(RunConfig.NEW_REPORT, "image", file_name)
        page.screenshot(path=image_dir)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

通过page = item.funcargs[“page”] 拿到playwright的驱动，截图判断逻辑有点复杂，不过我已经实现了。

总结

playwright还不稳定，我在使用的时候时常报一些错误，错误日志也不友好。计划在正式项目中使用的谨慎考虑，估计有一些坑要踩。

不熟悉playwright的API，可以通过官方文档，或者是项目自带的测试用例，或者阅读项目源码都是很好的学习方式。

---

最后

如果你想学习自动化测试，那么下面这套视频应该会帮到你很多

最后我这里给你们分享一下我所积累和整理的一些文档和学习资料，有需要直接领取就可以了！

以上内容，对于软件测试的朋友来说应该是最全面最完整的备战仓库了，为了更好地整理每个模块，我也参考了很多网上的优质博文和项目，力求不漏掉每一个知识点，很多朋友靠着这些内容进行复习，拿到了BATJ等大厂的offer，这个仓库也已经帮助了很多的软件测试的学习者，希望也能帮助到你。

​​

​​​​