Python开源自动化工具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操作系统。

如果你想学习自动化测试，我这边给你推荐一套视频，这个视频可以说是B站播放全网第一的自动化测试教程，同时在线人数到达1000人，并且还有笔记可以领取及各路大神技术交流：798478386    

【已更新】B站讲的最详细的Python接口自动化测试实战教程全集（实战最新版）_哔哩哔哩_bilibili【已更新】B站讲的最详细的Python接口自动化测试实战教程全集（实战最新版）共计200条视频，包括：1、接口自动化之为什么要做接口自动化、2、接口自动化之request全局观、3、接口自动化之接口实战等，UP主更多精彩视频，请关注UP账号。https://www.bilibili.com/video/BV17p4y1B77x/?spm_id_from=333.337.search-card.all.click

官网：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
3. Usage: index [options] [command]
5. Options:
6. -V, --version output the version number
7. -b, --browser browser to use, one of cr, chromium, ff, firefox, wk,
8. webkit (default: "chromium")
9. --color-scheme emulate preferred color scheme, "light" or "dark"
10. --device emulate device, for example "iPhone 11"
11. --geolocation specify geolocation coordinates, for example
12. "37.819722,-122.478611"
13. --lang specify language / locale, for example "en-GB"
14. --proxy-server specify proxy server, for example "http://myproxy:3128" or
15. "socks5://myproxy:8080"
16. --timezone time zone to emulate, for example "Europe/Rome"
17. --timeout timeout for Playwright actions in milliseconds (default:
18. "10000")
19. --user-agent specify user agent string
20. --viewport-size specify browser viewport size in pixels, for example "1280,
21. 720"
22. -h, --help display help for command
24. Commands:
25. open [url] open page in browser specified via -b, --browser
26. cr [url] open page in Chromium
27. ff [url] open page in Firefox
28. wk [url] open page in WebKit
29. codegen [options] [url] open page and generate code for user actions
30. screenshot [options] capture a page screenshot
31. pdf [options] save page as pdf
32. install Ensure browsers necessary for this version of Playwright
33. are installed
34. help [command] display help for command

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

3、实操演示

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

1）录制脚本

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

1. python3 -m playwright codegen --help
3. Usage: index codegen [options] [url]
5. open page and generate code for user actions
7. Options:
8. -o, --output saves the generated script to a file
9. --target language to use, one of javascript, python, python-async, csharp (default: "python")
10. -h, --help display help for command
12. Examples:
14. $ codegen
15. $ codegen --target=python
16. $ -b webkit codegen https://example.com

其中:

• python -m playwright codegen  录制脚本
• --help  帮助文档
• -o  生成自动化脚本的目录
• --target 脚本语言，包含 JS 和 Python，分别对应值为：python 和 javascript
• -b  指定浏览器驱动

比如，我要在baidu.com搜索，用chromium驱动，将结果保存为mikezhou.py的python文件。

1. # 我们通过下面命令打开 Chrome 浏览器开始录制脚本
2. # 指定生成语言为:Python（默认Python，可选）
3. # 保存的文件名：mikezhou.py（可选）
4. # 浏览器驱动：webkit（默认webkit，可选）
5. # 最后跟着要打开的目标网站（默认仅仅是打开浏览器，可选）
6. python3 -m playwright codegen --target python -o 'mikezhou.py' -b chromium https://www.baidu.com

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

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

1. from playwright import sync_playwright
3. def run(playwright):
4. browser = playwright.chromium.launch(headless=False)
5. context = browser.newContext()
7. # Open new page
8. page = context.newPage()
10. # Go to https://www.baidu.com/
11. page.goto("https://www.baidu.com/")
13. # Click input[name="wd"]
14. page.click("input[name=\"wd\"]")
16. # Fill input[name="wd"]
17. page.fill("input[name=\"wd\"]", "禾目大")
19. # Press CapsLock
20. page.press("input[name=\"wd\"]", "CapsLock")
22. # Fill input[name="wd"]
23. page.fill("input[name=\"wd\"]", "自动化测试实战宝典 ")
25. # Press Enter
26. page.press("input[name=\"wd\"]", "Enter")
27. # 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"
29. # Close page
30. page.close()
32. # ---------------------
33. context.close()
34. browser.close()
36. with sync_playwright() as playwright:
37. run(playwright)

2）支持同步

同步的关键字为：sync_playwright

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

1. from time import sleep
2. from playwright import sync_playwright
4. # 注意：默认是无头模式
5. with sync_playwright() as p:
6. # 分别对应三个浏览器驱动
7. for browser_type in [p.chromium, p.firefox, p.webkit]:
9. # 指定为有头模式，方便查看
10. browser = browser_type.launch(headless=False)
11. page = browser.newPage()
12. page.goto('http://baidu.com')
14. # 执行一次搜索操作
15. page.fill("input[name=\"wd\"]", "自动化测试实战宝典")
16. with page.expect_navigation():
17. page.press("input[name=\"wd\"]", "Enter")
19. # 等待页面加载完全
20. page.waitForSelector("text=搜索工具")
22. # 截图
23. page.screenshot(path=f'test-{browser_type.name}.png')
25. # 休眠3s
26. sleep(3)
28. # 关闭浏览器
29. browser.close()

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

3）支持异步

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

1. import asyncio
2. from playwright import async_playwright
4. # 异步执行
5. async def main():
6. async with async_playwright() as p:
7. for browser_type in [p.chromium, p.firefox, p.webkit]:
8. # 指定为有头模式，方便查看
9. browser = await browser_type.launch(headless=False)
10. page = await browser.newPage()
12. await page.goto('http://baidu.com')
14. # 执行一次搜索操作
15. await page.fill("input[name=\"wd\"]", "自动化测试实战宝典")
16. await page.press("input[name=\"wd\"]", "Enter")
18. # 等待页面加载完全
19. await page.waitForSelector("text=搜索工具")
21. # 截图
22. await page.screenshot(path=f'test-{browser_type.name}.png')
23. await browser.close()
25. asyncio.get_event_loop().run_until_complete(main())

4）支持移动端

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

1. from playwright import sync_playwright
3. with sync_playwright() as p:
4. iphone_11 = p.devices['iPhone 11 Pro']
5. browser = p.webkit.launch(headless=False)
6. context = browser.newContext(
7. **iphone_11,
8. locale='en-US',
9. geolocation={ 'longitude': 12.492507, 'latitude': 41.889938 },
10. permissions=['geolocation']
11. )
12. page = context.newPage()
13. page.goto('https://maps.google.com')
14. page.click('text="Your location"')
15. page.screenshot(path='colosseum-iphone.png')
16. browser.close()

5）支持Pytest框架

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

1. def test_playwright_is_visible_on_google(page):
2. page.goto("https://www.google.com")
3. page.type("input[name=q]", "Playwright GitHub")
4. page.click("input[type=submit]")
5. page.waitForSelector("text=microsoft/Playwright")

当然，除了上面列举出来的特性，还有更多有意思的用法，感兴趣的读者可以自行探索一下。

4、小结

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

• 跨浏览器，支持Chromium、Firefox、WebKit；
• 跨操作系统，支持Linux、Mac、Windows；
• 可提供录制生成代码功能，解放双手；
• 可用于移动端；

目前存在的缺点就是生态和文档还不是非常完备，比如没有API中文文档、没有较好的教程和示例供学习。不过相信，随着知道的人越来越多，未来会越来越好。

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