概述

playwright是由微软开发的Web UI自动化测试工具， 支持Node.js、Python、C# 和 Java语言，本文将介绍playwright的特性以及它的简单使用。

playwright特性

playwright具有以下特点：

一、支持所有主流浏览器

• 支持所有主流浏览器：基于Chromium内核的Google Chrome 和 Microsoft Edge浏览器), WebKit内核的Apple Safari 和 Mozilla Firefox浏览器，不支持IE11。
• 跨平台：Windows、Linux 和macOS
• 可用于模拟移动端WEB应用的测试，不支持在真机上测试。
• 支持无头模式（默认）和有头模式
   

二、快速可靠的执行

• 自动等待元素
• Playwright基于Websocket协议，可以接受浏览器（服务端）的信号。selenium采用的是HTTP协议，只能客户端发起请求。
• 浏览器上下文并行：单个浏览器实例下创建多个浏览器上下文，每个浏览器上下文可以处理多个页面。
• 有弹性的元素选择：可以使用文本、可访问标签选择元素。

三、强大的自动化能力

• playwright是一个进程外自动化驱动程序，它不受页面内JavaScript执行范围的限制，可以自动化控制多个页面。
• 强大的网络控制：Playwright 引入了上下文范围的网络拦截来存根和模拟网络请求。
• 现代web特性：支持Shadow DOM选择，元素位置定位，页面提示处理，Web Worker等Web API。
• 覆盖所有场景：支持文件下载、上传、OOPIF（out-of-process iframes），输入、点击，暗黑模式等。
   

安装

Playwright有Node.js、Python、C# 和 Java语言版本，本文介绍Python版本的Playwright使用方法。

Playwright的Python版本仓库地址：https://github.com/microsoft/playwright-python

官方文档地址：Getting started | Playwright Python

Playwright安装简单，pip安装时会自动下载浏览器驱动：

1. pip install playwright

2. playwright install # 安装支持的浏览器：cr, chromium, ff, firefox, wk 和 webkit

3. playwright install chromium # 安装指定的chromium浏览器

安装时会自动下载浏览器依赖，windows系统在%USERPROFILE%\AppData\Local\ms-playwright 路径下。

命令行工具

脚本录制

在命令行窗口使用如下语法格式进行脚本录制：

npx playwright codegen [options] [url]

options参数：

-o, --output <file name> ：保存生成脚本
--target <language> ：生成的脚本语言，可以设置javascript, test, python, python-async和csharp，默认为python。
-b, --browser <browserType> ：要使用的浏览器，可以选择cr, chromium, ff, firefox, wk和webkit，默认chromium。
--channel <channel>：chromium版本，比如chrome, chrome-beta, msedge-dev等，
--color-scheme <scheme>：模拟器的颜色主题，可选择light 或者 dark样式。
--device <deviceName> ：模拟的设备，比如iPhone 11。
--save-storage <filename> ：保存上下文状态，用于保存cookies 和localStorage，可用它来实现重用。例如playwright codegen --save-storage=auth.json
--load-storage <filename> ：加载--save-storage 保存的数据，重用认证数据。
--proxy-server <proxy> ：指定代理服务器
--timezone <time zone> ： 指定时区
--geolocation <coordinates> ：指定地理位置坐标
--lang <language> ：指定语言/地区，比如中国大陆：zh-CN
--timeout <timeout> ：超时时间，定位毫秒，默认10000ms
--user-agent <ua string> ：用户代理
--viewport-size <size> ：浏览器窗口大小
-h, --help ：查看帮助信息

 示例：模拟iPhone 12 Pro设备打开百度，使用Chromium驱动，生成的脚本语言设置为python，保存名称为test_playwright.py：

playwright codegen -o test_playwright.py --target python  -b chromium --device="iPhone 12 Pro" https://www.baidu.com/

对页面进行的操作会生成对应脚本代码。

打开网页

语法格式：

npx playwright open [options] [url]

除了没有 -o 和 --target options参数外，playwright open 支持 playwright codegen 的其它参数。

1. playwright open https://www.baidu.com/ # 默认使用Chromium打开

2. playwright wk https://www.baidu.com/ # 使用WebKit打开

3. playwright open --device="iPhone 12 Pro" https://www.baidu.com/ # 使用iPhone 12 Pro模拟器打开

截图

语法格式：

npx playwright open [options] [url]

除了没有 -o 和 --target options参数外，playwright open 支持 playwright codegen 的其它参数。

1. playwright open https://www.baidu.com/ # 默认使用Chromium打开

2. playwright wk https://www.baidu.com/ # 使用WebKit打开

3. playwright open --device="iPhone 12 Pro" https://www.baidu.com/ # 使用iPhone 12 Pro模拟器打开

截图

语法格式：

npx playwright screenshot [options] <url> <filename>

options参数和 playwright codegen 的选项类似，可以使用 playwright screenshot --help 命令查看。

1. playwright screenshot --device="iPhone 12 Pro" -b wk https://www.baidu.com/ baidu-iphone.png # 截取显示的页面

2. playwright screenshot --full-page --device="iPhone 12 Pro" -b wk https://www.baidu.com/ baidu-iphone-full-page.png # 截取当前全部页面

同步和异步API

Playwright支持同步和异步两种API，使用异步API需要导入asyncio库，它是一个可以用来实现Python协程的库，

下面介绍如何使用python语言编写简单的playwright自动化脚本。

一共有2条测试用例，用例1步骤如下：

1. chrome浏览器打开百度
2. 搜索框输入“test”
3. 点击百度一下搜索
4. 点击搜索结果的第2页

用例2步骤：

1. chrome浏览器打开搜狗搜索
2. 搜索框输入“test”
3. 点击搜狗搜索
4. 点击搜索结果的第2页

1、同步方式

1. import time

2. from playwright.sync_api import sync_playwright

4. def testcase1():

5. print('testcase1 start')

6. with sync_playwright() as p:

7. browser = p.chromium.launch(headless=False)

8. page = browser.new_page()

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

10. print(page.title())

11. page.fill("input[name=\"wd\"]", "test")

12. page.click("text=百度一下")

13. page.click("#page >> text=2")

14. browser.close()

15. print('testcase1 done')

17. def testcase2():

18. print('testcase2 start')

19. with sync_playwright() as p:

20. browser2 = p.chromium.launch(headless=False)

21. page2 = browser2.new_page()

22. page2.goto("https://www.sogou.com/")

23. print(page2.title())

24. page2.fill("input[name=\"query\"]", "test")

25. page2.click("text=搜狗搜索")

26. page2.click("#sogou_page_2")

27. browser2.close()

28. print('testcase2 done')

30. start = time.time()

31. testcase1()

32. testcase2()

33. end = time.time()

34. print('Running time: %s Seconds'%(end-start))

执行结果：

1. testcase1 start

2. 百度一下，你就知道

3. testcase1 done

4. testcase2 start

5. 搜狗搜索引擎 - 上网从搜狗开始

6. testcase2 done

7. Running time: 11.476110458374023 Seconds

2、异步方式

2. import asyncio

3. import time

5. from playwright.async_api import async_playwright

7. async def testcase1():

8. print('testcase1 start')

9. async with async_playwright() as p:

10. browser = await p.chromium.launch(headless=False)

11. page = await browser.new_page()

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

13. print(await page.title())

14. await page.fill("input[name=\"wd\"]", "test")

15. await page.click("text=百度一下")

16. await page.click("#page >> text=2")

17. await browser.close()

18. print('testcase1 done')

20. async def testcase2():

21. print('testcase2 start')

22. async with async_playwright() as p:

23. browser2 = await p.chromium.launch(headless=False)

24. page2 = await browser2.new_page()

25. await page2.goto("https://www.sogou.com/")

26. print(await page2.title())

27. await page2.fill("input[name=\"query\"]", "test")

28. await page2.click("text=搜狗搜索")

29. await page2.click("#sogou_page_2")

30. await browser2.close()

31. print('testcase2 done')

33. async def main():

34. task1 = asyncio.create_task(testcase1())

35. task2 = asyncio.create_task(testcase2())

36. tasks = [task1,task2]

37. print('before await')

38. await asyncio.gather(*tasks)

40. start = time.time()

41. asyncio.run(main())

42. end = time.time()

43. print('Running time: %s Seconds'%(end-start))

执行结果：

1. before await

2. testcase1 start

3. testcase2 start

4. 百度一下，你就知道

5. 搜狗搜索引擎 - 上网从搜狗开始

6. testcase1 done

7. testcase2 done

8. Running time: 6.0248863697052 Seconds

可以看到，使用异步编程的方式可以显著提升测试效率。

浏览器

前面提到过，Playwright支持所有主流浏览器，下面介绍4种浏览器的启动方法：

1. # chrome

2. browser = p.chromium.launch(channel="chrome", headless=False)

3. # Microsoft Edge

4. browser = p.chromium.launch(channel="msedge", headless=False)

5. # firefox

6. browser = p.firefox.launch(headless=False)

7. # webkit

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

浏览器上下文

在进行web自动化控制之前需要对浏览器进行实例化，比如：

browser = p.chromium.launch(channel="chrome", headless=False)

browser是一个Chromium实例，创建实例其实是比较耗费资源的，Playwright支持在一个browser实例下创建多个浏览器上下文（BrowserContext），BrowserContext的创建速度很快，并且比创建browser实例消耗资源更少。对于多页面场景可以使用创建浏览器上下文的方式。

1. import asyncio

3. from playwright.async_api import async_playwright

5. async def testcase1():

6. print('testcase1 start')

7. async with async_playwright() as p:

8. browser = await p.chromium.launch(headless=False)

9. page = await browser.new_page()

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

11. print(await page.title())

12. await page.fill("input[name=\"wd\"]", "test")

13. await page.click("text=百度一下")

14. await page.click("#page >> text=2")

16. context = await browser.new_context()

17. page2 = await context.new_page()

18. await page2.goto("https://www.sogou.com/")

19. print(await page2.title())

20. await page2.fill("input[name=\"query\"]", "test")

21. await page2.click("text=搜狗搜索")

22. await page2.click("#sogou_page_2")

23. print(await page.title())

24. print('testcase1 done')

26. asyncio.run(testcase1())

多页面

一个浏览器上下文可以有多个页面，也就是多个窗口。

1. async def testcase2():

2. print('testcase2 start')

3. async with async_playwright() as p:

4. browser = await p.chromium.launch(headless=False)

5. context = await browser.new_context()

6. page1 = await context.new_page()

7. await page1.goto("https://www.sogou.com/")

8. print(await page1.title())

9. await page1.fill("input[name=\"query\"]", "test")

10. await page1.click("text=搜狗搜索")

11. await page1.click("#sogou_page_2")

13. page2 = await context.new_page()

14. await page2.goto("https://www.baidu.com/")

15. print(await page2.title())

16. print('testcase2 done')

断言

Python中可以使用assert 进行断言：

assert page.title() == "百度一下，你就知道"

除了使用assert断言以外，还可以使用功能更加强大的断言方法Hamcrest ，具有丰富的断言匹配器。

Hamcrest文档：PyHamcrest Tutorial — PyHamcrest 2.0.2 documentation

安装PyHamcrest：

pip install PyHamcrest

1. from hamcrest import *

3. assert_that(page.title(), equal_to("百度一下，你就知道"))

playwright Robot Framework库

如果你使用robot framework来管理和编写测试用例，可以使用robotframework-browser测试库。

browser测试库的github地址：https://github.com/MarketSquare/robotframework-browser, 安装方法参考README.md文档。

关键字使用说明文档：https://marketsquare.github.io/robotframework-browser/Browser.html

安装失败：
https://github.com/MarketSquare/robotframework-browser/issues/682

可能是node版本太高，可以使用node v12.9.1版本
 

常见报错

Node版本问题

1. Node.js is only supported on Windows 8.1, Windows Server 2012 R2, or higher.

2. Setting the NODE_SKIP_PLATFORM_CHECK environment variable to 1 skips this

3. check, but Node.js might not execute correctly. Any issues encountered on

4. unsupported platforms will not be fixed.Traceback (most recent call last):

5. File "test.py", line 112, in <module>

6. p = RobotPlaywright()

7. File "test.py", line 29, in __init__

8. self.playwright = sync_playwright().start()

9. File "D:\attrobot3\lib\site-packages\playwright\sync_api\_context_manager.py",

10. line 76, in start

11. return self.__enter__()

12. File "D:\attrobot3\lib\site-packages\playwright\sync_api\_context_manager.py",

13. line 71, in __enter__

14. playwright = self._playwright

15. AttributeError: 'PlaywrightContextManager' object has no attribute '_playwright'

17. Task was destroyed but it is pending!

18. task: <Task pending coro=<Connection.run.<locals>.init() running at D:\attrobot3

19. \lib\site-packages\playwright\_impl\_connection.py:175> wait_for=<Future pending

20. cb=[<TaskWakeupMethWrapper object at 0x0000000003199288>()]>>

如果是windows7系统，错误原因可能是node版本太高，v12.16.2以上版本不支持win7，node历史版本下载地址：Index of /dist/。

卸载安装低版本后再次执行脚本，如果还是报上面的错误，可以尝试设置系统变量 NODE_SKIP_PLATFORM_CHECK 绕过校验。

set NODE_SKIP_PLATFORM_CHECK=1

安装msedge报错

1. $ playwright install msedge

2. 无法加载文件 C:\Program Files\Python37\Lib\site-packages\playwright\driver\package\bin\reinstall_msedge_stable_win.ps1，因为在此系统中禁止执行脚本。有关详细信息，请参阅 "get-help about_signing"。

3. + CategoryInfo : NotSpecified: (:) [], ParentContainsErrorRecordE

4. xception

5. + FullyQualifiedErrorId : RuntimeException

解决方案：
打开 Windows PowerShell，执行如下命令：

set-ExecutionPolicy RemoteSigned

重新执行 playwright install msedge 命令安装。 

  最后： 下方这份完整的软件测试视频教程已经整理上传完成，需要的朋友们可以自行领取【保证100%免费】