自动化测试之playwright工具

playwright是由微软开发的Web UI自动化测试工具，支持Node.js、Python、C# 和 Java语言。

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安装时会自动下载浏览器驱动：

pip install playwright

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

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 ：查看帮助信息

录制模式
Playwright 带有命令行工具（录制功能），可用于记录用户交互并生成代码（Java、Python等）。其实就是类似于 Selenium IDE。

1、常规录制

打开命令行，输入

playwright codegen

自动打开浏览器和录制界面

通过操作（点击、输入等）浏览器页面，脚本也会自动增加操作的步骤。

此外，录制工具还可以获取元素的定位。点击停止录制，之后再点击 Explore 后，在页面点击想要定位的元素，即可获取到该元素定位的值。

作为演示，输入百度网址打开百度页面，搜索框中输入“playwright”，点击“百度一下”按钮，录制代码如下

from playwright.sync_api import sync_playwright
 
def run(playwright):
    browser = playwright.chromium.launch(headless=False)
    context = browser.new_context()
 
    # Open new page
    page = context.new_page()
 
    # Go to https://www.baidu.com/
    page.goto("https://www.baidu.com/")
 
    # Click input[name="wd"]
    page.click("input[name=\"wd\"]")
 
    # Fill input[name="wd"]
    page.fill("input[name=\"wd\"]", "playwright")
 
    # Click text=百度一下
    page.click("text=百度一下")
    # assert page.url == "https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=1&rsv_idx=1&tn=baidu&wd=playwright&fenlei=256&oq=playwright&rsv_pq=bf1abd6c000029f7&rsv_t=1937PYyfHvfyS6fay57V1zS1iCIiYC4%2B8I6srjLqYYkXrf8H9kce%2BLQKVzA&rqlang=cn&rsv_dl=tb&rsv_enter=0&rsv_btype=t&prefixsug=playwright&rsp=5"
 
    # Click text=百度一下
    # with page.expect_navigation(url="https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=1&rsv_idx=1&tn=baidu&wd=playwright&fenlei=256&oq=playwright&rsv_pq=a03207ba00008498&rsv_t=ecf2ko5wPyHrjSHwUBLAZZwxkyObcfsg5ge7apN1BeAdigW%2BzzxD%2F3CJI7k&rqlang=cn&rsv_dl=tb&rsv_enter=0&rsv_btype=t&prefixsug=playwright&rsp=5"):
    with page.expect_navigation():
        page.click("text=百度一下")
 
    # Click text=百度一下
    page.click("text=百度一下")
    # assert page.url == "https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=1&rsv_idx=1&tn=baidu&wd=playwright&fenlei=256&oq=playwright&rsv_pq=bf1abd6c000029f7&rsv_t=1937PYyfHvfyS6fay57V1zS1iCIiYC4%2B8I6srjLqYYkXrf8H9kce%2BLQKVzA&rqlang=cn&rsv_dl=tb&rsv_enter=0&rsv_btype=t&prefixsug=playwright&rsp=5"
 
    # ---------------------
    context.close()
    browser.close()
 
with sync_playwright() as playwright:
    run(playwright)

最后将录制的脚本复制出来，可做适当的调整。

调整后的脚本代码：

from playwright.sync_api import sync_playwright  # 导入playwright同步api
 
def run(playwright):  # 定义run方法
    browser = playwright.chromium.launch(headless=False)  # 创建chromium的browser对象，当前使用的是playwright安装的自带的chromium
    context = browser.new_context()  # 创建context对象，context之间是相互隔离的，可以理解为轻量级的浏览器实例
 
    page = context.new_page()  # 创建page对象，真正打开浏览器界面
 
    page.goto("https://www.baidu.com/")  # 跳转到百度url
 
    page.fill("input[name=\"wd\"]", "playwright")  # 通过css定位在搜索框中输入"playwright"
 
    with page.expect_navigation():  # 预期结果，点击"百度一下"按钮后会发生页面导航
        page.click("text=百度一下")  # 通过playwright自定义的文字定位器定位"百度一下"按钮并点击
 
    # ---------------------
    context.close()  # 关闭context
    browser.close()  # 关闭browser
 
with sync_playwright() as playwright:  # playwright使用入口，通过上下文方式
    run(playwright)  # 调用run方法，将playwright实例传入

2、模拟移动设备录制

open 可以模拟移动设备和平板设备

例如模拟 iPhone 14 访问博客园。

playwright open --device="iPhone 14" home.cnblogs.com/u/keima/

通过以上代码可以了解到：

playwright支持同步和异步两种使用方法
不需要为每个浏览器下载webdriver
相比selenium多了一层context抽象
支持无头浏览器，且较为推荐（headless默认值为True）
可以使用传统定位方式（CSS，XPATH等），也有自定义的新的定位方式（如文字定位）
没有使用selenium的先定位元素，再进行操作的方式，而是在操作方法中传入了元素定位，定位和操作同时进行（其实也playwright也提供了单独的定位方法，作为可选）
很多方法使用了with的上下文语法

六、编写模式
使用 IDE（如 PyCharm、Visual Studio Code 等）进行编写代码并运行程序。

1、启动浏览器（无头模式）

Playwright 可以启动三种浏览器中的 chromium、firefox、webkit 任何一种。

示例操作如下，打开浏览器、跳转百度、屏幕截图、输出页面标题、关闭浏览器。

from playwright.sync_api import sync_playwright
 
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto("https://www.baidu.com/")
page.screenshot(path="example.png")
print(page.title())
browser.close()

2、启动浏览器（有头模式）

默认情况下，Playwright 以无头模式运行浏览器。要查看浏览器 UI（有头模式），请在启动浏览器时传递 headless=False 标志，还可以使用 slow_mo 来减慢执行速度。

from playwright.sync_api import sync_playwright
 
with sync_playwright() as p:
browser = p.chromium.launch(headless=False, slow_mo=50)
page = browser.new_page()
page.goto("https://www.baidu.com/")
page.screenshot(path="example.png")
print(page.title())
browser.close()

3、异步

Playwright 支持 API 的两种变体：同步和异步。

支持异步，如果你的项目使用 asyncio，则应该使用 async API。

import asyncio
from playwright.async_api import async_playwright
async def main():
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
await page.goto("https://www.baidu.com/")
print(await page.title())
await browser.close()
 
asyncio.run(main())

4、context

Playwright 支持上下文管理：一个浏览器实例下可以有多个context，将浏览器分割成不同的上下文，以实现会话的分离。

如需要不同用户登录同一个网页，不需要创建多个浏览器实例，只需要创建多个context即可。

context1 = browser.new_context()
context2 = browser.new_context()

5、page

一个context下可以有多个page，一个page就代表一个浏览器的标签页或弹出窗口，用于进行页面操作。

page = context.new_page()
 
# 显式导航，类似于在浏览器中输入URL
page.goto('https://www.baidu.com/')
# 在输入框中输入字符
page.fill('#search', '百度')
# 点击提交按钮
page.click('#submit')
# 打印当前url
print(page.url)

6、browser

Playwright内置了很多支持的浏览器驱动，不用再像selenium那样去寻找对应匹配版本的浏览器驱动版本下载。

只需要创建相应的browser实例。

browser = playwright.chromium.launch()    #Chrome
browser = playwright.firefox.launch()    #火狐

7、frame
一个页面至少包含一个主frame，新的frame通过iframe标签定义，frame之间可以进行嵌套，只有先定位到frame才能对frame里面的元素进行定位和操作。playwright默认使用page进行的元素操作会重定向到主frame上。

# 通过名称获得frame
frame = page.frame('frame-login')
 
# 通过frame的url获得frame
frame = page.frame(url=r'.*domain.*')
 
# 通过选择器获得frame
frame_element_handle = page.query_selector('.frame-class')
frame = frame_element_handle.content_frame()
 
# 操作frame中的元素
frame.fill('#username-input', 'JoJo')

8、选择器
所有元素操作都需要使用选择器定位到要操作的元素，playwright同时支持css、xpath和自定义的选择器，使用时无需指定类型，playwright会自动进行判断。

# Using data-test-id= selector engine
page.click('data-test-id=foo')
 
# CSS and XPath selector engines are automatically detected
page.click('div')
page.click('//html/body/div')
 
# Find node by text substring
page.click('text=Hello w')
 
# Explicit CSS and XPath notation
page.click('css=div')
page.click('xpath=//html/body/div')
 
# Click an element with text 'Sign Up' inside of a #free-month-promo.
page.click('#free-month-promo >> text=Sign Up')
 
# Capture textContent of a section that contains an element with text 'Selectors'.
section_text = page.eval_on_selector('*css=section >> text=Selectors', 'e => e.textContent')

9、自动等待
像page.click(selector)、page.fill(selector, value)之类的元素操作会自动等待元素可见且可操作。

# Playwright 会等待 #search 元素出现在 DOM 中
page.fill('#search', 'query')
 
# Playwright 会等待元素停止动画并接受点击
page.click('#search')
 
# 等待 #search 出现在 DOM 中
page.wait_for_selector('#search', state='attached')
# 等待 #promo 可见, 例如具有 `visibility:visible`
page.wait_for_selector('#promo')
 
# 等待 #details 变得不可见, 例如通过 `display:none`.
page.wait_for_selector('#details', state='hidden')
# 等待 #promo 从 DOM 中移除
page.wait_for_selector('#promo', state='detached')

七、实例

1、网易云签到

import time
  
from playwright.sync_api import Playwright, sync_playwright, expect
  
  
def run(playwright: Playwright) -> None:
    browser = playwright.chromium.launch(headless=False)
    context = browser.new_context(viewport={'width': 1920, 'height': 1080})
  
    # Open new page
    page = context.new_page()
  
    # Go to https://music.163.com/
    page.goto("https://music.163.com/")
  
    # Click text=用户登录
    page.frame_locator("iframe[name=\"contentFrame\"]").locator("text=用户登录").click()
  
    # Click text=选择其他登录模式
    page.locator("text=选择其他登录模式").click()
  
    # Check input[type="checkbox"]
    page.locator("input[type=\"checkbox\"]").check()
  
    # Click text=QQ登录
    with page.expect_popup() as popup_info:
        page.locator("text=QQ登录").click()
    page1 = popup_info.value
  
    # Click #img_out_****
    page1.frame_locator("iframe[name=\"ptlogin_iframe\"]").locator("#img_out_****").click()
    # token用*代替
    page1.wait_for_url(f"https://music.163.com/back/sns?key=*")
  
    # Close page
    page1.close()
  
    # Click text=我的音乐
    page.locator("text=我的音乐").click()
    page.wait_for_url("https://music.163.com/#/my/m/music/playlist?id=152392364")
  
    time.sleep(3)
    # Click a:has-text("播放")
    page.frame_locator("iframe[name=\"contentFrame\"]").locator("a:has-text(\"播放\")").click()
    time.sleep(10)
  
    # Click text=网易云音乐
    page.locator("text=网易云音乐").click()
    page.wait_for_url("https://music.163.com/#")
  
    # Click a:has-text("签到")
    page.frame_locator("iframe[name=\"contentFrame\"]").locator('//*[@id="discover-module"]/div[2]/div[1]/div/div/div/div/a/i').click()
    time.sleep(10)
    # Close page
    page.close()
  
    # ---------------------
    context.close()
    browser.close()
    print('*******************************  签到完成  *******************************')
  
  
with sync_playwright() as playwright:
    run(playwright)

点击

左键点击：page.click(“id=su”)

点击元素左上角：page.click(‘id=su’, position={‘x’: 0, ‘y’: 0})

Shift + click：page.click(“id=su”, modifiers=[‘Shift’])

强制点击：page.click(“id=su”, force=True)

右键点击：page.click(“id=su”, button=‘right’)

双击：page.dblclick(“id=su”)

悬停在元素上：page.hover(‘id=su’)

————————————————

参考：https://blog.csdn.net/qq_40279560/article/details/129297181?spm=1001.2101.3001.6650.4&utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7ERate-4-129297181-blog-131596058.235%5Ev43%5Epc_blog_bottom_relevance_base2&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7ERate-4-129297181-blog-131596058.235%5Ev43%5Epc_blog_bottom_relevance_base2&utm_relevant_index=9

https://blog.csdn.net/qq_40279560/article/details/129297181?spm=1001.2101.3001.6650.4&utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7ERate-4-129297181-blog-131596058.235%5Ev43%5Epc_blog_bottom_relevance_base2&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7ERate-4-129297181-blog-131596058.235%5Ev43%5Epc_blog_bottom_relevance_base2&utm_relevant_index=9

posted @ 2024-01-31 11:43 konglingbin 阅读(1752) 评论(0) 收藏举报

刷新页面返回顶部

konglingbin

自动化测试之playwright工具

playwright是由微软开发的Web UI自动化测试工具， 支持Node.js、Python、C# 和 Java语言。

公告

playwright是由微软开发的Web UI自动化测试工具，支持Node.js、Python、C# 和 Java语言。