自动化测试框架Playwright安装以及使用

最近,微软开源了一个非常强大的自动化项目叫 playwright-python

它支持主流的浏览器,包含:Chrome、Firefox、Safari、Microsoft Edge 等,同时支持以无头模式、有头模式运行,并提供了同步、异步的 API,可以结合 Pytest 测试框架 使用,并且支持浏览器端的自动化脚本录制。

项目地址:https://github.com/microsoft/playwright-python

而对于Python爱好者来说,还有一个更大的福利,这个项目是针对Python语言的纯自动化工具,可以做到,连一行代码都不用写,就能实现自动化功能。听起来,简直太碉堡了!

可能你会觉得有点不可思议,真的不用写一行代码吗?但它真的就是这么厉害。下面我们一起看下这个神器。

1、Playwright介绍

Playwright是一个强大的Python库,仅用一个API即可自动执行Chromium、Firefox、WebKit等主流浏览器自动化操作,并同时支持以无头模式、有头模式运行。

Playwright提供的自动化技术是绿色的、功能强大、可靠且快速,支持Linux、Mac以及Windows操作系统。

官网:https://playwright.dev/

从官网的解释,官方给Playwright定位是一款真正意义上的Web端到端测试工具。

2、Playwright安装

Playwright功能强大,但它的安装步骤,非常简单,只需要 2 步:

第 1 步,安装 playwright-python 依赖库 (需要注意的是,playwright库需要依赖Python3.7+以上)

#此处可能是pip/pip3,或者两者皆可

pip3 install playwright
可以在https://pypi.org/project/playwright/查看它的依赖版本信息。

第 2 步,安装主流的浏览器驱动

这样,会将 Chromeium、Firefox、Webkit 浏览器驱动下载到本地

# 安装浏览器驱动(安装过程稍微有点慢,请耐心等待)

python3 -m playwright install

如果想查看Playwright支持的功能, 可以直接在命令行输入:

  1. python3 -m playwright help

  2. Usage: index [options] [command]

  3. Options:

  4. -V, --version output the version number

  5. -b, --browser <browserType> browser to use, one of cr, chromium, ff, firefox, wk,

  6. webkit (default: "chromium")

  7. --color-scheme <scheme> emulate preferred color scheme, "light" or "dark"

  8. --device <deviceName> emulate device, for example "iPhone 11"

  9. --geolocation <coordinates> specify geolocation coordinates, for example

  10. "37.819722,-122.478611"

  11. --lang <language> specify language / locale, for example "en-GB"

  12. --proxy-server <proxy> specify proxy server, for example "http://myproxy:3128" or

  13. "socks5://myproxy:8080"

  14. --timezone <time zone> time zone to emulate, for example "Europe/Rome"

  15. --timeout <timeout> timeout for Playwright actions in milliseconds (default:

  16. "10000")

  17. --user-agent <ua string> specify user agent string

  18. --viewport-size <size> specify browser viewport size in pixels, for example "1280,

  19. 720"

  20. -h, --help display help for command

  21. Commands:

  22. open [url] open page in browser specified via -b, --browser

  23. cr [url] open page in Chromium

  24. ff [url] open page in Firefox

  25. wk [url] open page in WebKit

  26. codegen [options] [url] open page and generate code for user actions

  27. screenshot [options] <url> <filename> capture a page screenshot

  28. pdf [options] <url> <filename> save page as pdf

  29. install Ensure browsers necessary for this version of Playwright

  30. are installed

  31. help [command] display help for command

从命令行帮助信息中可以看出,Playwright支持的功能相当丰富!

3、实操演示

开篇就提到,使用Playwright无需写一行代码,我们只需手动操作浏览器,它会录制我们的操作,然后自动生成代码脚本。

1)录制脚本

我们先查看录制脚本的命令说明

  1. python3 -m playwright codegen --help

  2. Usage: index codegen [options] [url]

  3. open page and generate code for user actions

  4. Options:

  5. -o, --output <file name> saves the generated script to a file

  6. --target <language> language to use, one of javascript, python, python-async, csharp (default: "python")

  7. -h, --help display help for command

  8. Examples:

  9. $ codegen

  10. $ codegen --target=python

  11. $ -b webkit codegen https://example.com

其中:

python -m playwright codegen  录制脚本
--help  帮助文档
-o  生成自动化脚本的目录
--target 脚本语言,包含 JS 和 Python,分别对应值为:python 和 javascript
-b  指定浏览器驱动
比如,我要在baidu.com搜索,用chromium驱动,将结果保存为mikezhou.py的python文件。# 我们通过下面命令打开 Chrome 浏览器开始录制脚本
# 指定生成语言为:Python(默认Python,可选)
# 保存的文件名:mikezhou.py(可选)
# 浏览器驱动:webkit(默认webkit,可选)
# 最后跟着要打开的目标网站(默认仅仅是打开浏览器,可选)
python3 -m playwright codegen --target python -o 'mikezhou.py' -b chromium https://www.baidu.com

命令行输入后会自动打开浏览器,然后可以看见在浏览器上的一举一动都会被自动翻译成代码,如下所示:

最后,自动化脚本会自动生成,保存到文件中mikezhou.py, 且上述所有的人工操作,都会被自动转化成代码:

2)支持同步

同步的关键字为:sync_playwright

比如,我们依次使用三个浏览器内核打开浏览器,然后百度一下,接着对在搜索界面截图,最后关闭浏览器

from time import sleep
from playwright import sync_playwright

# 注意:默认是无头模式
with sync_playwright() as p:
    # 分别对应三个浏览器驱动
    for browser_type in [p.chromium, p.firefox, p.webkit]:

        # 指定为有头模式,方便查看
        browser = browser_type.launch(headless=False)
        page = browser.newPage()
        page.goto('http://baidu.com')

  1. from playwright import sync_playwright

  2. def run(playwright):

  3. browser = playwright.chromium.launch(headless=False)

  4. context = browser.newContext()

  5. # Open new page

  6. page = context.newPage()

  7. # Go to https://www.baidu.com/

  8. page.goto("https://www.baidu.com/")

  9. # Click input[name="wd"]

  10. page.click("input[name=\"wd\"]")

  11. # Fill input[name="wd"]

  12. page.fill("input[name=\"wd\"]", "禾目大")

  13. # Press CapsLock

  14. page.press("input[name=\"wd\"]", "CapsLock")

  15. # Fill input[name="wd"]

  16. page.fill("input[name=\"wd\"]", "自动化测试实战宝典 ")

  17. # Press Enter

  18. page.press("input[name=\"wd\"]", "Enter")

  19. # assert page.url() == "https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=1&rsv_idx=1&tn=baidu&wd=%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95%E5%AE%9E%E6%88%98%E5%AE%9D%E5%85%B8%20&fenlei=256&rsv_pq=af40e9aa00012d5a&rsv_t=c659gpz2%2Fjri1SAoIXdT9gP%2BmrqufXzRtMSSAL0n0fv7GSoLF5vaiNVPA3U&rqlang=cn&rsv_enter=1&rsv_dl=tb&rsv_sug3=38&rsv_sug1=22&rsv_sug7=100&rsv_sug2=0&rsv_btype=i&inputT=8034&rsv_sug4=9153"

  20. # Close page

  21. page.close()

  22. # ---------------------

  23. context.close()

  24. browser.close()

  25. with sync_playwright() as playwright:

  26. run(playwright)

  27. # 执行一次搜索操作

  28. page.fill("input[name=\"wd\"]", "自动化测试实战宝典")

  29. with page.expect_navigation():

  30. page.press("input[name=\"wd\"]", "Enter")

  31. # 等待页面加载完全

  32. page.waitForSelector("text=搜索工具")

  33. # 截图

  34. page.screenshot(path=f'test-{browser_type.name}.png')

  35. # 休眠3s

  36. sleep(3)

  37. # 关闭浏览器

  38. browser.close()

需要指出的是,playwright-python 内置的 API 基本上囊括常见的自动化操作。

3)支持异步

异步步的关键字为:async_playwright,异步操作可结合asyncio同时进行三个浏览器操作。

  1. import asyncio

  2. from playwright import async_playwright

  3. # 异步执行

  4. async def main():

  5. async with async_playwright() as p:

  6. for browser_type in [p.chromium, p.firefox, p.webkit]:

  7. # 指定为有头模式,方便查看

  8. browser = await browser_type.launch(headless=False)

  9. page = await browser.newPage()

  10. await page.goto('http://baidu.com')

  11. # 执行一次搜索操作

  12. await page.fill("input[name=\"wd\"]", "自动化测试实战宝典")

  13. await page.press("input[name=\"wd\"]", "Enter")

  14. # 等待页面加载完全

  15. await page.waitForSelector("text=搜索工具")

  16. # 截图

  17. await page.screenshot(path=f'test-{browser_type.name}.png')

  18. await browser.close()

  19. asyncio.get_event_loop().run_until_complete(main())

4)支持移动端

更厉害的是,playwright还可支持移动端的浏览器模拟。下面是官方文档提供的一段代码,模拟在给定地理位置上手机iphone 11 pro上的Safari浏览器,首先导航到maps.google.com,然后执行定位并截图。

  1. from playwright import sync_playwright

  2. with sync_playwright() as p:

  3. iphone_11 = p.devices['iPhone 11 Pro']

  4. browser = p.webkit.launch(headless=False)

  5. context = browser.newContext(

  6. **iphone_11,

  7. locale='en-US',

  8. geolocation={ 'longitude': 12.492507, 'latitude': 41.889938 },

  9. permissions=['geolocation']

  10. )

  11. page = context.newPage()

  12. page.goto('https://maps.google.com')

  13. page.click('text="Your location"')

  14. page.screenshot(path='colosseum-iphone.png')

  15. browser.close()

5)支持Pytest框架

另外,还可以配合pytest插件一起使用,给出一段官网示例:

def test_playwright_is_visible_on_google(page):
    page.goto("https://www.google.com")
    page.type("input[name=q]", "Playwright GitHub")
    page.click("input[type=submit]")
    page.waitForSelector("text=microsoft/Playwright")
当然,除了上面列举出来的特性,还有更多有意思的用法,感兴趣的读者可以自行探索一下。

4、小结

playwright相比已有的自动化测试框架来说,具有有很多优势,比如:

跨浏览器,支持Chromium、Firefox、WebKit;
跨操作系统,支持Linux、Mac、Windows;
可提供录制生成代码功能,解放双手;
可用于移动端;
目前存在的缺点就是生态和文档还不是非常完备,比如没有API中文文档、没有较好的教程和示例供学习。不过相信,随着知道的人越来越多,未来会越来越好。

最后,再说一个小秘密,Playwright 是一个跨语言的自动化框架,除了支持 Python,也支持Java、JS 等,更加详细的功能可以通过官方项目去解锁~

 

总结:

感谢每一个认真阅读我文章的人!!!

作为一位过来人也是希望大家少走一些弯路,如果你不想再体验一次学习时找不到资料,没人解答问题,坚持几天便放弃的感受的话,在这里我给大家分享一些自动化测试的学习资源,希望能给你前进的路上带来帮助。

  1. 文档获取方式:

  2. 加入我的软件测试交流群:680748947免费获取~(同行大佬一起学术交流,每晚都有大佬直播分享技术知识点)

这份文档,对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库,这个仓库也陪伴我走过了最艰难的路程,希望也能帮助到你!

以上均可以分享,只需要你搜索vx公众号:程序员雨果,即可免费领取

  • 17
    点赞
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值