写在开头的说明这篇文章是自学Playwright时整理的分享给想学这个框架的同学但示例中的地址不方便直接提供给所有人使用因此被我修改了学会框架api后请在自己项目中尝试哈原理Playwright是微软开发的Web应用的自动化测试框架。它和另外一个 web自动化框架Selenium有 什么区别呢区别一Selenium 只提供了 Web 自动化功能 如果你要做自动化测试需要结合其它自动化测试框架而 Playwright 是面向自动化测试的除了Web自动化功能它也包含了自动化测试的功能框架区别二两者的自动化原理有些差别如下图所示安装Playwright 也支持多种语言开发比如 JavaScript/TypeScript Python Java C#本教程 使用的是 Python语言安装 playwright 客户端库pip install playwright安装 浏览器playwright 这个项目默认使用自己编译好的几种浏览器比如chromium firefox webkit这些浏览器是通过各自的开源项目编译出来的。和我们下载安装的ChromeFirefoxSafri这些品牌浏览器stock browser的区别请看这里playwright 每个版本都绑定 自编译浏览器的某个版本 可以通过 官方Release Note 看到对应关系安装很简单执行playwright install即可会出现如下浏览器下载界面Downloading Chromium 119.0.6045.9 (playwright build v1084) from https://playwright.azureedge.net/builds/chromium/1084/chromium-win64.zip 120.8 Mb [] 100% 0.0s Chromium 119.0.6045.9 (playwright build v1084) downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\chromium-1084 Downloading FFMPEG playwright build v1009 from https://playwright.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip 1.4 Mb [] 100% 0.0s FFMPEG playwright build v1009 downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\ffmpeg-1009 Downloading Firefox 118.0.1 (playwright build v1425) from https://playwright.azureedge.net/builds/firefox/1425/firefox-win64.zip 80 Mb [] 100% 0.0s Firefox 118.0.1 (playwright build v1425) downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\firefox-1425 Downloading Webkit 17.4 (playwright build v1921) from https://playwright.azureedge.net/builds/webkit/1921/webkit-win64.zip 44.5 Mb [] 100% 0.0s Webkit 17.4 (playwright build v1921) downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\webkit-1921如果你只需要自动化一种浏览器可以在参数中指定比如playwright install chromium注意: 如果使用虚拟环境,那么playwright程序往往不在Path目录下,那么需要进入全路径下执行playwright install chromium更好的方式就是你先激活虚拟环境,然后直接使用命令playwright install chromiumplaywright 也可以自动化 已经安装好的品牌浏览器比如Chrome, Edge, Firefox等后文会有讲解品牌浏览器往往会自动更新如果使用Selenium自动化就需要不断下载新的驱动。playwright使用自编译浏览器不会自动更新从而避免驱动和浏览器不匹配的问题。当然如果你只是想测试和品牌浏览器的兼容性就无需上述下载了。简单示例from playwright.sync_api import sync_playwright input(1....) # 启动 playwright driver 进程 p sync_playwright().start() input(2....) # 启动浏览器返回 Browser 类型对象 browser p.chromium.launch(headlessFalse) # 创建新页面返回 Page 类型对象 page browser.new_page() page.goto(https://xxxxxx/cdn2/files/selenium/stock1.html) print(page.title()) # 打印网页标题栏# 输入通讯点击查询。这是定位与操作是自动化重点后文详细讲解 page.locator(#kw).fill(通讯) # 输入通讯 page.locator(#go).click() # 点击查询# 打印所有搜索内容 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) input(3....) # 关闭浏览器 browser.close() input(4....) # 关闭 playwright driver 进程 p.stop()可以这样换一种浏览器# 启动firefox浏览器 browser p.firefox.launch(headlessFalse) # 启动webkit浏览器 browser p.webkit.launch(headlessFalse)可以通过参数executable_path指定使用安装的其它浏览器# 加上 executable_path参数 browser p.chromium.launch(headlessFalse, executable_pathc:\Program Files\Google\Chrome\Application\chrome.exe)可以使用with as会话管理我们的代码简化不需要调用start()和stop()from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.launch(headlessFalse) page browser.new_page() page.goto(https:/xxxxxx/cdn2/files/selenium/stock1.html) print(page.title()) page.locator(#kw).fill(通讯\n) page.locator(#go).click() # 打印所有搜索内容 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) browser.close()界面等待上面的代码大家发现不能打印出股票搜索的结果原因是点击查询后立即就去检查搜索结果了这时界面上还没有呈现结果所以返回的是空结果需要等待一段时间比如2秒。但是目前我们不能在Playwright中使用 time.sleep 进行等待。因为Playwright底层使用的是异步的python库进行各种事件处理time.sleep 会破坏异步框架的处理逻辑。可以使用 Page 对象的wait_for_timeout方法达到等待效果单位是毫秒page.wait_for_timeout(1000)自动化代码助手Playwright 内置了代码助手的功能可以帮我们产生 自动化代码输入如下命令即可启动代码助手playwright codegen使用playwright命令 和上面一样需要先进入playwright安装路径 或者虚拟环境激活后直接执行执行之后会启动空白页,以及代码区域注意这个只能作为助手它主要是记录人对页面的输入。并不能取代人自己写代码特别是那些获取页面上信息的代码比如这个打印标题栏就没法自动化生成print(page.title())# 打印所有搜索内容 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text())跟踪功能Playwright 有个特色功能 跟踪tracing启用跟踪功能后 可以在执行自动化后通过记录的跟踪数据文件 回看自动化过程中的每个细节。下面的的代码进行了自动化搜索股票并打开跟踪功能保存 跟踪数据文件 为trace.zip。from playwright.sync_api import sync_playwright p sync_playwright().start() browser p.chromium.launch(headlessFalse) # 创建 BrowserContext对象 context browser.new_context() # 启动跟踪功能 context.tracing.start(snapshotsTrue, sourcesTrue, screenshotsTrue) page context.new_page() page.goto(https://xxxxxx/cdn2/files/selenium/stock1.html) # 搜索名称中包含 通讯 的股票 page.locator(#kw).fill(通讯) page.locator(#go).click() page.wait_for_timeout(1000) # 等待1秒 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) # 搜索名称中包含 软件 的股票 page.locator(#kw).fill(软件) page.locator(#go).click() page.wait_for_timeout(1000) # 等待1秒 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) # 结束跟踪 context.tracing.stop(pathtrace.zip) browser.close() p.stop()执行完以后我们发现当前工作目录下面多了 trace.zip 这个跟踪数据文件。怎么查看这个跟踪文件呢有2种方法直接访问 trace.playwright.dev 这个网站上传 跟踪文件执行命令playwright show-trace trace.zip注意: 使用playwright命令 和上面一样需要先进入playwright安装路径 或者虚拟环境激活后直接执行这个功能对自动化测试特别有用。测试结束后对有疑问的测试用例的执行过程可以详细的查看具体信息。
01-Playwright快速上手
写在开头的说明这篇文章是自学Playwright时整理的分享给想学这个框架的同学但示例中的地址不方便直接提供给所有人使用因此被我修改了学会框架api后请在自己项目中尝试哈原理Playwright是微软开发的Web应用的自动化测试框架。它和另外一个 web自动化框架Selenium有 什么区别呢区别一Selenium 只提供了 Web 自动化功能 如果你要做自动化测试需要结合其它自动化测试框架而 Playwright 是面向自动化测试的除了Web自动化功能它也包含了自动化测试的功能框架区别二两者的自动化原理有些差别如下图所示安装Playwright 也支持多种语言开发比如 JavaScript/TypeScript Python Java C#本教程 使用的是 Python语言安装 playwright 客户端库pip install playwright安装 浏览器playwright 这个项目默认使用自己编译好的几种浏览器比如chromium firefox webkit这些浏览器是通过各自的开源项目编译出来的。和我们下载安装的ChromeFirefoxSafri这些品牌浏览器stock browser的区别请看这里playwright 每个版本都绑定 自编译浏览器的某个版本 可以通过 官方Release Note 看到对应关系安装很简单执行playwright install即可会出现如下浏览器下载界面Downloading Chromium 119.0.6045.9 (playwright build v1084) from https://playwright.azureedge.net/builds/chromium/1084/chromium-win64.zip 120.8 Mb [] 100% 0.0s Chromium 119.0.6045.9 (playwright build v1084) downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\chromium-1084 Downloading FFMPEG playwright build v1009 from https://playwright.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip 1.4 Mb [] 100% 0.0s FFMPEG playwright build v1009 downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\ffmpeg-1009 Downloading Firefox 118.0.1 (playwright build v1425) from https://playwright.azureedge.net/builds/firefox/1425/firefox-win64.zip 80 Mb [] 100% 0.0s Firefox 118.0.1 (playwright build v1425) downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\firefox-1425 Downloading Webkit 17.4 (playwright build v1921) from https://playwright.azureedge.net/builds/webkit/1921/webkit-win64.zip 44.5 Mb [] 100% 0.0s Webkit 17.4 (playwright build v1921) downloaded to C:\Users\jcyrs\AppData\Local\ms-playwright\webkit-1921如果你只需要自动化一种浏览器可以在参数中指定比如playwright install chromium注意: 如果使用虚拟环境,那么playwright程序往往不在Path目录下,那么需要进入全路径下执行playwright install chromium更好的方式就是你先激活虚拟环境,然后直接使用命令playwright install chromiumplaywright 也可以自动化 已经安装好的品牌浏览器比如Chrome, Edge, Firefox等后文会有讲解品牌浏览器往往会自动更新如果使用Selenium自动化就需要不断下载新的驱动。playwright使用自编译浏览器不会自动更新从而避免驱动和浏览器不匹配的问题。当然如果你只是想测试和品牌浏览器的兼容性就无需上述下载了。简单示例from playwright.sync_api import sync_playwright input(1....) # 启动 playwright driver 进程 p sync_playwright().start() input(2....) # 启动浏览器返回 Browser 类型对象 browser p.chromium.launch(headlessFalse) # 创建新页面返回 Page 类型对象 page browser.new_page() page.goto(https://xxxxxx/cdn2/files/selenium/stock1.html) print(page.title()) # 打印网页标题栏# 输入通讯点击查询。这是定位与操作是自动化重点后文详细讲解 page.locator(#kw).fill(通讯) # 输入通讯 page.locator(#go).click() # 点击查询# 打印所有搜索内容 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) input(3....) # 关闭浏览器 browser.close() input(4....) # 关闭 playwright driver 进程 p.stop()可以这样换一种浏览器# 启动firefox浏览器 browser p.firefox.launch(headlessFalse) # 启动webkit浏览器 browser p.webkit.launch(headlessFalse)可以通过参数executable_path指定使用安装的其它浏览器# 加上 executable_path参数 browser p.chromium.launch(headlessFalse, executable_pathc:\Program Files\Google\Chrome\Application\chrome.exe)可以使用with as会话管理我们的代码简化不需要调用start()和stop()from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.launch(headlessFalse) page browser.new_page() page.goto(https:/xxxxxx/cdn2/files/selenium/stock1.html) print(page.title()) page.locator(#kw).fill(通讯\n) page.locator(#go).click() # 打印所有搜索内容 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) browser.close()界面等待上面的代码大家发现不能打印出股票搜索的结果原因是点击查询后立即就去检查搜索结果了这时界面上还没有呈现结果所以返回的是空结果需要等待一段时间比如2秒。但是目前我们不能在Playwright中使用 time.sleep 进行等待。因为Playwright底层使用的是异步的python库进行各种事件处理time.sleep 会破坏异步框架的处理逻辑。可以使用 Page 对象的wait_for_timeout方法达到等待效果单位是毫秒page.wait_for_timeout(1000)自动化代码助手Playwright 内置了代码助手的功能可以帮我们产生 自动化代码输入如下命令即可启动代码助手playwright codegen使用playwright命令 和上面一样需要先进入playwright安装路径 或者虚拟环境激活后直接执行执行之后会启动空白页,以及代码区域注意这个只能作为助手它主要是记录人对页面的输入。并不能取代人自己写代码特别是那些获取页面上信息的代码比如这个打印标题栏就没法自动化生成print(page.title())# 打印所有搜索内容 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text())跟踪功能Playwright 有个特色功能 跟踪tracing启用跟踪功能后 可以在执行自动化后通过记录的跟踪数据文件 回看自动化过程中的每个细节。下面的的代码进行了自动化搜索股票并打开跟踪功能保存 跟踪数据文件 为trace.zip。from playwright.sync_api import sync_playwright p sync_playwright().start() browser p.chromium.launch(headlessFalse) # 创建 BrowserContext对象 context browser.new_context() # 启动跟踪功能 context.tracing.start(snapshotsTrue, sourcesTrue, screenshotsTrue) page context.new_page() page.goto(https://xxxxxx/cdn2/files/selenium/stock1.html) # 搜索名称中包含 通讯 的股票 page.locator(#kw).fill(通讯) page.locator(#go).click() page.wait_for_timeout(1000) # 等待1秒 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) # 搜索名称中包含 软件 的股票 page.locator(#kw).fill(软件) page.locator(#go).click() page.wait_for_timeout(1000) # 等待1秒 lcs page.locator(.result-item).all() for lc in lcs: print(lc.inner_text()) # 结束跟踪 context.tracing.stop(pathtrace.zip) browser.close() p.stop()执行完以后我们发现当前工作目录下面多了 trace.zip 这个跟踪数据文件。怎么查看这个跟踪文件呢有2种方法直接访问 trace.playwright.dev 这个网站上传 跟踪文件执行命令playwright show-trace trace.zip注意: 使用playwright命令 和上面一样需要先进入playwright安装路径 或者虚拟环境激活后直接执行这个功能对自动化测试特别有用。测试结束后对有疑问的测试用例的执行过程可以详细的查看具体信息。
