发行说明
版本 1.51
亮点
-
indexed_db 的新选项 browser_context.storage_state() 允许保存和恢复 IndexedDB 内容。当您的应用程序使用 IndexedDB API 存储身份验证令牌(如 Firebase Authentication)时非常有用。
这是一个遵循身份验证指南的示例
# Save storage state into the file. Make sure to include IndexedDB.
storage = await context.storage_state(path="state.json", indexed_db=True)
# Create a new context with the saved storage state.
context = await browser.new_context(storage_state="state.json") -
locator.filter() 的新选项 visible 允许仅匹配可见元素。
# Ignore invisible todo items.
todo_items = page.get_by_test_id("todo-item").filter(visible=True)
# Check there are exactly 3 visible ones.
await expect(todo_items).to_have_count(3) -
方法 page.emulate_media() 和 browser.new_context() 的新选项
contrast
允许模拟prefers-contrast
媒体功能。 -
新选项 fail_on_status_code 使通过 APIRequestContext 发出的所有 fetch 请求在响应代码不是 2xx 和 3xx 时抛出错误。
浏览器版本
- Chromium 134.0.6998.35
- Mozilla Firefox 135.0
- WebKit 18.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 133
- Microsoft Edge 133
版本 1.50
异步 Pytest 插件
其他
- 添加了方法 expect(locator).to_have_accessible_error_message() 以断言 Locator 指向的元素具有给定的 aria errormessage。
UI 更新
- Codegen 中用于选择元素以生成 aria 快照的新按钮。
- 其他详细信息(例如按下的键)现在与跟踪中的操作 API 调用一起显示。
canvas
内容在跟踪中的显示容易出错。显示现在默认禁用,可以通过Display canvas content
UI 设置启用。Call
和Network
面板现在显示其他时间信息。
重大更改
- 如果目标元素不是
<input>
、<select>
或其他一些可编辑元素,则 expect(locator).to_be_editable() 和 locator.is_editable() 现在会抛出错误。
浏览器版本
- Chromium 133.0.6943.16
- Mozilla Firefox 134.0
- WebKit 18.2
此版本还针对以下稳定通道进行了测试
- Google Chrome 132
- Microsoft Edge 132
版本 1.49
Aria 快照
新断言 expect(locator).to_match_aria_snapshot() 通过与预期可访问性树(以 YAML 表示)进行比较来验证页面结构。
page.goto("https://playwright.net.cn")
expect(page.locator('body')).to_match_aria_snapshot('''
- banner:
- heading /Playwright enables reliable/ [level=1]
- link "Get started"
- link "Star microsoft/playwright on GitHub"
- main:
- img "Browsers (Chromium, Firefox, WebKit)"
- heading "Any browser • Any platform • One API"
''')
您可以使用 测试生成器 或调用 locator.aria_snapshot() 来生成此断言。
在 aria 快照指南中了解更多信息。
跟踪组
新方法 tracing.group() 允许您在跟踪查看器中以可视方式对操作进行分组。
# All actions between group and group_end
# will be shown in the trace viewer as a group.
page.context.tracing.group("Open Playwright.dev > API")
page.goto("https://playwright.net.cn/")
page.get_by_role("link", name="API").click()
page.context.tracing.group_end()
重大更改:chrome
和 msedge
通道切换到新的无头模式
如果您在 playwright.config.ts
中使用以下通道之一,则此更改会影响您
chrome
、chrome-dev
、chrome-beta
或chrome-canary
msedge
、msedge-dev
、msedge-beta
或msedge-canary
更新到 Playwright v1.49 后,运行您的测试套件。如果它仍然通过,则一切顺利。否则,您可能需要更新快照,并调整一些关于 PDF 查看器和扩展程序的测试代码。有关更多详细信息,请参阅 issue #33566。
尝试新的 Chromium 无头模式
您可以使用 'chromium'
通道选择加入新的无头模式。正如 官方 Chrome 文档所述
另一方面,新的无头模式是真正的 Chrome 浏览器,因此更真实、可靠,并提供更多功能。这使其更适合高精度端到端 Web 应用程序测试或浏览器扩展程序测试。
有关您可能遇到的潜在中断以及关于 Chromium 无头模式的更多详细信息,请参阅 issue #33566。如果您在选择加入后看到任何问题,请提交 issue。
pytest test_login.py --browser-channel chromium
其他
- Ubuntu 20.04 和 Debian 11 上的 WebKit 将不再有更新。我们建议您将操作系统更新到更高版本。
- 快照内的
<canvas>
元素现在绘制预览。 - 不再支持 Python 3.8。
浏览器版本
- Chromium 131.0.6778.33
- Mozilla Firefox 132.0
- WebKit 18.2
此版本还针对以下稳定通道进行了测试
- Google Chrome 130
- Microsoft Edge 130
版本 1.48
WebSocket 路由
新方法 page.route_web_socket() 和 browser_context.route_web_socket() 允许拦截、修改和模拟页面中启动的 WebSocket 连接。以下是一个简单的示例,通过使用 "response"
响应 "request"
来模拟 WebSocket 通信。
def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
if message == "request":
ws.send("response")
page.route_web_socket("/ws", lambda ws: ws.on_message(
lambda message: message_handler(ws, message)
))
有关更多详细信息,请参阅 WebSocketRoute。
UI 更新
- HTML 报告中用于注释和测试位置的新“复制”按钮。
- 路由方法调用(如 route.fulfill())不再在报告和跟踪查看器中显示。您可以在网络选项卡中查看哪些网络请求被路由。
- 网络选项卡中请求的新“复制为 cURL”和“复制为 fetch”按钮。
其他
- 新方法 page.request_gc() 可能有助于检测内存泄漏。
- 由 APIRequestContext 发出的请求现在在 HAR 中记录详细的计时和安全信息。
浏览器版本
- Chromium 130.0.6723.19
- Mozilla Firefox 130.0
- WebKit 18.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 129
- Microsoft Edge 129
版本 1.47
网络选项卡改进
跟踪查看器中的网络选项卡有几个不错的改进
- 按资源类型和 URL 过滤
- 更好地显示查询字符串参数
- 字体资源预览
其他
mcr.microsoft.com/playwright/python:v1.47.0
现在提供基于 Ubuntu 24.04 Noble 的 Playwright 镜像。要使用基于 22.04 jammy 的镜像,请改用mcr.microsoft.com/playwright/python:v1.47.0-jammy
。- Playwright Docker 镜像的
:latest
/:focal
/:jammy
标签不再发布。为了获得更好的稳定性和可重现性,请固定到特定版本。 - TLS 客户端证书现在可以通过传递 client_certificates.cert 和 client_certificates.key 作为字节而不是文件路径从内存中传递。
- locator.select_option() 中的 no_wait_after 已被弃用。
- 我们已经看到有关 GitHub Actions
macos-13
上 Webkit 行为异常的报告。我们建议将 GitHub Actions 升级到macos-14
。
浏览器版本
- Chromium 129.0.6668.29
- Mozilla Firefox 130.0
- WebKit 18.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 128
- Microsoft Edge 128
版本 1.46
TLS 客户端证书
Playwright 现在允许提供客户端证书,以便服务器可以按照 TLS 客户端身份验证的规定对其进行验证。
您可以将客户端证书作为 browser.new_context() 和 api_request.new_context() 的参数提供。以下代码片段为 https://example.com
设置客户端证书
context = browser.new_context(
client_certificates=[
{
"origin": "https://example.com",
"certPath": "client-certificates/cert.pem",
"keyPath": "client-certificates/key.pem",
}
],
)
Trace Viewer 更新
- 文本附件的内容现在以内联方式呈现在附件窗格中。
- 用于显示/隐藏路由操作(如 route.continue_())的新设置。
- 请求方法和状态显示在网络详细信息选项卡中。
- 用于将源文件位置复制到剪贴板的新按钮。
- 元数据窗格现在显示
base_url
。
其他
- api_request_context.fetch() 中的新
maxRetries
选项,用于在ECONNRESET
网络错误时重试。
浏览器版本
- Chromium 128.0.6613.18
- Mozilla Firefox 128.0
- WebKit 18.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 127
- Microsoft Edge 127
版本 1.45
时钟
利用新的 Clock API 可以在测试中操作和控制时间,以验证与时间相关的行为。此 API 涵盖许多常见场景,包括
- 使用预定义时间进行测试;
- 保持一致的时间和计时器;
- 监控不活动状态;
- 手动按时间推进。
# Initialize clock with some time before the test time and let the page load
# naturally. `Date.now` will progress as the timers fire.
page.clock.install(time=datetime.datetime(2024, 2, 2, 8, 0, 0))
page.goto("https://127.0.0.1:3333")
# Pretend that the user closed the laptop lid and opened it again at 10am.
# Pause the time once reached that point.
page.clock.pause_at(datetime.datetime(2024, 2, 2, 10, 0, 0))
# Assert the page state.
expect(page.get_by_test_id("current-time")).to_have_text("2/2/2024, 10:00:00 AM")
# Close the laptop lid again and open it at 10:30am.
page.clock.fast_forward("30:00")
expect(page.get_by_test_id("current-time")).to_have_text("2/2/2024, 10:30:00 AM")
有关更多详细信息,请参阅 时钟指南。
其他
-
方法 locator.set_input_files() 现在支持为
<input type=file webkitdirectory>
元素上传目录。page.get_by_label("Upload directory").set_input_files('mydir')
-
多种方法(如 locator.click() 或 locator.press())现在支持
ControlOrMeta
修饰键。此键在 macOS 上映射到Meta
,在 Windows 和 Linux 上映射到Control
。# Press the common keyboard shortcut Control+S or Meta+S to trigger a "Save" operation.
page.keyboard.press("ControlOrMeta+S") -
api_request.new_context() 中的新属性
httpCredentials.send
,允许始终发送Authorization
标头,或者仅在响应401 Unauthorized
时发送。 -
Playwright 现在支持 Ubuntu 24.04 上的 Chromium、Firefox 和 WebKit。
-
v1.45 是最后一个接收 macOS 12 Monterey WebKit 更新的版本。请更新 macOS 以继续使用最新的 WebKit。
浏览器版本
- Chromium 127.0.6533.5
- Mozilla Firefox 127.0
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 126
- Microsoft Edge 126
版本 1.44
新 API
辅助功能断言
-
expect(locator).to_have_accessible_name() 检查元素是否具有指定的辅助功能名称
locator = page.get_by_role("button")
expect(locator).to_have_accessible_name("Submit") -
expect(locator).to_have_accessible_description() 检查元素是否具有指定的辅助功能描述
locator = page.get_by_role("button")
expect(locator).to_have_accessible_description("Upload a photo") -
expect(locator).to_have_role() 检查元素是否具有指定的 ARIA 角色
locator = page.get_by_test_id("save-button")
expect(locator).to_have_role("button")
定位器处理程序
- 执行使用 page.add_locator_handler() 添加的处理程序后,Playwright 现在将等待直到触发处理程序的覆盖层不再可见。您可以使用新的
no_wait_after
选项选择退出此行为。 - 您可以在 page.add_locator_handler() 中使用新的
times
选项来指定处理程序应运行的最大次数。 - page.add_locator_handler() 中的处理程序现在接受定位器作为参数。
- 用于删除先前添加的定位器处理程序的新 page.remove_locator_handler() 方法。
locator = page.get_by_text("This interstitial covers the button")
page.add_locator_handler(locator, lambda overlay: overlay.locator("#close").click(), times=3, no_wait_after=True)
# Run your tests that can be interrupted by the overlay.
# ...
page.remove_locator_handler(locator)
其他选项
- expect(page).to_have_url() 现在支持
ignore_case
选项。
浏览器版本
- Chromium 125.0.6422.14
- Mozilla Firefox 125.0.1
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 124
- Microsoft Edge 124
版本 1.43
新 API
-
方法 browser_context.clear_cookies() 现在支持过滤器以仅删除某些 Cookie。
# Clear all cookies.
context.clear_cookies()
# New: clear cookies with a particular name.
context.clear_cookies(name="session-id")
# New: clear cookies for a particular domain.
context.clear_cookies(domain="my-origin.com") -
新方法 locator.content_frame 将 Locator 对象转换为 FrameLocator。当您在某处获得 Locator 对象,并且稍后希望与框架内的内容进行交互时,这可能很有用。
locator = page.locator("iframe[name='embedded']")
# ...
frame_locator = locator.content_frame
frame_locator.getByRole("button").click() -
新方法 frame_locator.owner 将 FrameLocator 对象转换为 Locator。当您在某处获得 FrameLocator 对象,并且稍后希望与
iframe
元素进行交互时,这可能很有用。frame_locator = page.frame_locator("iframe[name='embedded']")
# ...
locator = frame_locator.owner
expect(locator).to_be_visible() -
现在为 macOS-arm64 和 Linux-arm64 发布 Conda 构建。
浏览器版本
- Chromium 124.0.6367.8
- Mozilla Firefox 124.0
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 123
- Microsoft Edge 123
版本 1.42
新定位器处理程序
新方法 page.add_locator_handler() 注册一个回调,当指定的元素变为可见时将调用该回调,并且可能会阻止 Playwright 操作。回调可以消除覆盖层。这是一个在 cookie 对话框出现时关闭它的示例。
# Setup the handler.
page.add_locator_handler(
page.get_by_role("heading", name="Hej! You are in control of your cookies."),
lambda: page.get_by_role("button", name="Accept all").click(),
)
# Write the test as usual.
page.goto("https://www.ikea.com/")
page.get_by_role("link", name="Collection of blue and white").click()
expect(page.get_by_role("heading", name="Light and easy")).to_be_visible()
新 API
- page.pdf() 接受两个新选项 tagged 和 outline。
公告
- ⚠️ 不再支持 Ubuntu 18。
浏览器版本
- Chromium 123.0.6312.4
- Mozilla Firefox 123.0
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 122
- Microsoft Edge 123
版本 1.41
新 API
- 新方法 page.unroute_all() 删除由 page.route() 和 page.route_from_har() 注册的所有路由。可以选择等待正在进行的路由完成,或忽略来自它们的任何错误。
- 新方法 browser_context.unroute_all() 删除由 browser_context.route() 和 browser_context.route_from_har() 注册的所有路由。可以选择等待正在进行的路由完成,或忽略来自它们的任何错误。
- page.screenshot() 中的新选项 style 和 locator.screenshot() 中的 style,用于在拍摄屏幕截图之前向页面添加自定义 CSS。
浏览器版本
- Chromium 121.0.6167.57
- Mozilla Firefox 121.0
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 120
- Microsoft Edge 120
版本 1.40
测试生成器更新
用于生成断言的新工具
- “断言可见性”工具生成 expect(locator).to_be_visible()。
- “断言值”工具生成 expect(locator).to_have_value()。
- “断言文本”工具生成 expect(locator).to_contain_text()。
这是一个带有断言的生成测试示例
from playwright.sync_api import Page, expect
def test_example(page: Page) -> None:
page.goto("https://playwright.net.cn/")
page.get_by_role("link", name="Get started").click()
expect(page.get_by_label("Breadcrumbs").get_by_role("list")).to_contain_text("Installation")
expect(page.get_by_label("Search")).to_be_visible()
page.get_by_label("Search").click()
page.get_by_placeholder("Search docs").fill("locator")
expect(page.get_by_placeholder("Search docs")).to_have_value("locator");
新 API
- page.close() 中的选项 reason,browser_context.close() 中的 reason 和 browser.close() 中的 reason。关闭原因会报告给所有被关闭中断的操作。
- browser_type.launch_persistent_context() 中的选项 firefox_user_prefs。
其他更改
- 方法 download.path() 对失败和取消的下载抛出错误。
浏览器版本
- Chromium 120.0.6099.28
- Mozilla Firefox 119.0
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 119
- Microsoft Edge 119
版本 1.39
常青浏览器更新。
浏览器版本
- Chromium 119.0.6045.9
- Mozilla Firefox 118.0.1
- WebKit 17.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 118
- Microsoft Edge 118
版本 1.38
Trace Viewer 更新
- 缩放到时间范围。
- 网络面板重新设计。
新 API
弃用
- 以下方法已被弃用:page.type()、frame.type()、locator.type() 和 element_handle.type()。请改用速度更快的 locator.fill()。仅当页面上有特殊的键盘处理,并且您需要逐个按下按键时,才使用 locator.press_sequentially()。
浏览器版本
- Chromium 117.0.5938.62
- Mozilla Firefox 117.0
- WebKit 17.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 116
- Microsoft Edge 116
版本 1.37
亮点
- 新的 --full-page-screenshot 命令行标志允许在失败时截取整页屏幕截图。
- 现在可以通过使用 browser_context_args 标记来覆盖单个测试的上下文选项。
pytest-playwright
现在也发布在 Anaconda 上
📚 Debian 12 Bookworm 支持
Playwright 现在在 x86_64 和 arm64 上都支持 Debian 12 Bookworm,用于 Chromium、Firefox 和 WebKit。如果您遇到任何问题,请告知我们!
Linux 支持看起来像这样
Ubuntu 20.04 | Ubuntu 22.04 | Debian 11 | Debian 12 | |
---|---|---|---|---|
Chromium | ✅ | ✅ | ✅ | ✅ |
WebKit | ✅ | ✅ | ✅ | ✅ |
Firefox | ✅ | ✅ | ✅ | ✅ |
浏览器版本
- Chromium 116.0.5845.82
- Mozilla Firefox 115.0
- WebKit 17.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 115
- Microsoft Edge 115
版本 1.36
🏝️ 夏季维护版本。
浏览器版本
- Chromium 115.0.5790.75
- Mozilla Firefox 115.0
- WebKit 17.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 114
- Microsoft Edge 114
版本 1.35
亮点
-
方法 page.screenshot() 和 locator.screenshot() 的新选项
mask_color
用于更改默认的遮罩颜色。 -
用于卸载浏览器二进制文件的新
uninstall
CLI 命令$ playwright uninstall # remove browsers installed by this installation
$ playwright uninstall --all # remove all ever-install Playwright browsers
浏览器版本
- Chromium 115.0.5790.13
- Mozilla Firefox 113.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 114
- Microsoft Edge 114
版本 1.34
亮点
-
新的 locator.and_() 用于创建匹配两个定位器的定位器。
button = page.get_by_role("button").and_(page.get_by_title("Subscribe"))
-
新增事件 browser_context.on("console") 和 browser_context.on("dialog"),用于订阅来自给定浏览器上下文的任何页面的任何对话框和控制台消息。使用新的方法 console_message.page 和 dialog.page 来精确定位事件源。
浏览器版本
- Chromium 114.0.5735.26
- Mozilla Firefox 113.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 113
- Microsoft Edge 113
版本 1.33
定位器更新
-
使用 locator.or_() 创建一个定位器,该定位器匹配两个定位器中的任何一个。考虑这样一种情况:您想单击“新邮件”按钮,但有时会出现安全设置对话框。在这种情况下,您可以等待“新邮件”按钮或对话框,并采取相应的措施
new_email = page.get_by_role("button", name="New email")
dialog = page.get_by_text("Confirm security settings")
expect(new_email.or_(dialog)).is_visible()
if (dialog.is_visible()):
page.get_by_role("button", name="Dismiss").click()
new_email.click() -
在 locator.filter() 中使用新的选项 has_not 和 has_not_text 来查找不匹配特定条件的元素。
row_locator = page.locator("tr")
row_locator.filter(has_not_text="text in column 1").filter(
has_not=page.get_by_role("button", name="column 2 button")
).screenshot() -
使用新的 Web-First 断言 expect(locator).to_be_attached() 来确保元素存在于页面的 DOM 中。不要与 expect(locator).to_be_visible() 混淆,后者确保元素既已附加又可见。
新 API
- locator.or_()
- 在 locator.filter() 中的新选项 has_not
- 在 locator.filter() 中的新选项 has_not_text
- expect(locator).to_be_attached()
- 在 route.fetch() 中的新选项 timeout
⚠️ 突破性变更
mcr.microsoft.com/playwright/python:v1.33.0
现在提供基于 Ubuntu Jammy 的 Playwright 镜像。要使用基于 focal 的镜像,请使用mcr.microsoft.com/playwright/python:v1.33.0-focal
。
浏览器版本
- Chromium 113.0.5672.53
- Mozilla Firefox 112.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 112
- Microsoft Edge 112
版本 1.32
新 API
- 自定义 expect 消息,请参阅 测试断言文档。
- 在 page.route_from_har() 和 browser_context.route_from_har() 中的新选项 update_mode 和 update_content。
- 链式现有定位器对象,请参阅 定位器文档 以了解详情。
- 在方法 tracing.start_chunk() 中的新选项 name。
浏览器版本
- Chromium 112.0.5615.29
- Mozilla Firefox 111.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 111
- Microsoft Edge 111
版本 1.31
新 API
-
新断言 expect(locator).to_be_in_viewport() 确保定位器指向与视口相交的元素,根据 Intersection Observer API。
from playwright.sync_api import expect
locator = page.get_by_role("button")
# Make sure at least some part of element intersects viewport.
expect(locator).to_be_in_viewport()
# Make sure element is fully outside of viewport.
expect(locator).not_to_be_in_viewport()
# Make sure that at least half of the element intersects viewport.
expect(locator).to_be_in_viewport(ratio=0.5)
其他
- 跟踪查看器中的 DOM 快照现在可以在单独的窗口中打开。
- 方法 route.fetch() 的新选项 max_redirects。
- Playwright 现在支持 Debian 11 arm64。
- 官方 docker 镜像 现在包含 Node 18 而不是 Node 16。
浏览器版本
- Chromium 111.0.5563.19
- Mozilla Firefox 109.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 110
- Microsoft Edge 110
版本 1.30
浏览器版本
- Chromium 110.0.5481.38
- Mozilla Firefox 108.0.2
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 109
- Microsoft Edge 109
版本 1.29
新 API
-
新方法 route.fetch() 和 route.fulfill() 的新选项
json
def handle_route(route: Route):
# Fetch original settings.
response = route.fetch()
# Force settings theme to a predefined value.
json = response.json()
json["theme"] = "Solorized"
# Fulfill with modified data.
route.fulfill(json=json)
page.route("**/api/settings", handle_route) -
新方法 locator.all() 用于迭代所有匹配的元素
# Check all checkboxes!
checkboxes = page.get_by_role("checkbox")
for checkbox in checkboxes.all():
checkbox.check() -
locator.select_option() 现在通过 value 或 label 匹配
<select multiple>
<option value="red">Red</option>
<option value="green">Green</option>
<option value="blue">Blue</option>
</select>element.select_option("Red")
其他
- 方法 route.continue_() 中的选项
postData
现在支持 Serializable 值。
浏览器版本
- Chromium 109.0.5414.46
- Mozilla Firefox 107.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 108
- Microsoft Edge 108
版本 1.28
Playwright 工具
- CodeGen 中的实时定位器。 使用“Explore”工具为页面上的任何元素生成定位器。
新 API
浏览器版本
- Chromium 108.0.5359.29
- Mozilla Firefox 106.0
- WebKit 16.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 107
- Microsoft Edge 107
版本 1.27
定位器
使用这些新的 API,编写定位器成为一种乐趣
- page.get_by_text() 按文本内容定位。
- page.get_by_role() 按 ARIA 角色、ARIA 属性 和 可访问名称 定位。
- page.get_by_label() 按关联标签的文本定位表单控件。
- page.get_by_test_id() 基于其
data-testid
属性(可以配置其他属性)定位元素。 - page.get_by_placeholder() 按占位符定位输入框。
- page.get_by_alt_text() 按其替代文本定位元素,通常是图像。
- page.get_by_title() 按其标题定位元素。
page.get_by_label("User Name").fill("John")
page.get_by_label("Password").fill("secret-password")
page.get_by_role("button", name="Sign in").click()
expect(page.get_by_text("Welcome, John!")).to_be_visible()
所有相同的方法也适用于 Locator、FrameLocator 和 Frame 类。
其他亮点
- 正如在 v1.25 中宣布的那样,自 2022 年 12 月起将不再支持 Ubuntu 18。除此之外,从下一个 Playwright 版本开始,Ubuntu 18 上将不会有 WebKit 更新。
行为变更
-
expect(locator).to_have_attribute() 与空值不再匹配缺失的属性。例如,当
button
没有disabled
属性时,以下代码段将成功。expect(page.get_by_role("button")).to_have_attribute("disabled", "")
浏览器版本
- Chromium 107.0.5304.18
- Mozilla Firefox 105.0.1
- WebKit 16.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 106
- Microsoft Edge 106
版本 1.26
断言
- expect(locator).to_be_enabled() 的新选项
enabled
。 - expect(locator).to_have_text() 现在可以穿透打开的 shadow root。
- expect(locator).to_be_editable() 的新选项
editable
。 - expect(locator).to_be_visible() 的新选项
visible
。
其他亮点
- api_request_context.get() 和其他方法的 新选项
max_redirects
用于限制重定向计数。 - 现在支持 Python 3.11。
行为变更
许多 Playwright API 已经支持 wait_until: "domcontentloaded"
选项。例如
page.goto("https://playwright.net.cn", wait_until="domcontentloaded")
在 1.26 之前,这将等待所有 iframe 触发 DOMContentLoaded
事件。
为了与 Web 规范保持一致,'domcontentloaded'
值仅等待目标框架触发 'DOMContentLoaded'
事件。使用 wait_until="load"
等待所有 iframe。
浏览器版本
- Chromium 106.0.5249.30
- Mozilla Firefox 104.0
- WebKit 16.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 105
- Microsoft Edge 105
版本 1.25
公告
- 🎁 我们现在发布 Ubuntu 22.04 Jammy Jellyfish docker 镜像:
mcr.microsoft.com/playwright/python:v1.34.0-jammy
。 - 🪦 这是最后一个支持 macOS 10.15 的版本(自 1.21 起已弃用)。
- ⚠️ Ubuntu 18 现在已弃用,自 2022 年 12 月起将不再支持。
浏览器版本
- Chromium 105.0.5195.19
- Mozilla Firefox 103.0
- WebKit 16.0
此版本还针对以下稳定通道进行了测试
- Google Chrome 104
- Microsoft Edge 104
版本 1.24
🐂 Debian 11 Bullseye 支持
Playwright 现在在 x86_64 上支持 Debian 11 Bullseye,用于 Chromium、Firefox 和 WebKit。如果您遇到任何问题,请告诉我们!
Linux 支持看起来像这样
| | Ubuntu 20.04 | Ubuntu 22.04 | Debian 11 | :--- | :---: | :---: | :---: | :---: | | Chromium | ✅ | ✅ | ✅ | | WebKit | ✅ | ✅ | ✅ | | Firefox | ✅ | ✅ | ✅ |
新的入门文档
我们重写了入门文档,使其更侧重于端到端测试。请在 playwright.dev 上查看。
版本 1.23
网络回放
现在您可以将网络流量记录到 HAR 文件中,并在测试中重复使用此流量。
将网络记录到 HAR 文件
npx playwright open --save-har=github.har.zip https://github.com/microsoft
或者,您可以编程方式记录 HAR
- 同步
- 异步
context = browser.new_context(record_har_path="github.har.zip")
# ... do stuff ...
context.close()
context = await browser.new_context(record_har_path="github.har.zip")
# ... do stuff ...
await context.close()
使用新的方法 page.route_from_har() 或 browser_context.route_from_har() 从 HAR 文件中提供匹配的响应
- 同步
- 异步
context.route_from_har("github.har.zip")
await context.route_from_har("github.har.zip")
在 我们的文档 中阅读更多内容。
高级路由
您现在可以使用 route.fallback() 将路由推迟到其他处理程序。
考虑以下示例
- 同步
- 异步
# Remove a header from all requests
def remove_header_handler(route: Route) -> None:
headers = route.request.all_headers()
if "if-none-match" in headers:
del headers["if-none-match"]
route.fallback(headers=headers)
page.route("**/*", remove_header_handler)
# Abort all images
def abort_images_handler(route: Route) -> None:
if route.request.resource_type == "image":
route.abort()
else:
route.fallback()
page.route("**/*", abort_images_handler)
# Remove a header from all requests
async def remove_header_handler(route: Route) -> None:
headers = await route.request.all_headers()
if "if-none-match" in headers:
del headers["if-none-match"]
await route.fallback(headers=headers)
await page.route("**/*", remove_header_handler)
# Abort all images
async def abort_images_handler(route: Route) -> None:
if route.request.resource_type == "image":
await route.abort()
else:
await route.fallback()
await page.route("**/*", abort_images_handler)
请注意,新的方法 page.route_from_har() 和 browser_context.route_from_har() 也参与路由,并且可以被推迟。
Web-First 断言更新
- 新方法 expect(locator).to_have_values(),断言
<select multiple>
元素的所有选定值。 - 方法 expect(locator).to_contain_text() 和 expect(locator).to_have_text() 现在接受
ignore_case
选项。
其他
-
如果服务工作线程妨碍了您,您现在可以使用新的上下文选项
service_workers
轻松禁用它- 同步
- 异步
context = browser.new_context(service_workers="block")
page = context.new_page()context = await browser.new_context(service_workers="block")
page = await context.new_page() -
对
recordHar
上下文选项使用.zip
路径会自动压缩生成的 HAR- 同步
- 异步
context = browser.new_context(record_har_path="github.har.zip")
context = await browser.new_context(record_har_path="github.har.zip")
-
如果您打算手动编辑 HAR,请考虑使用
"minimal"
HAR 记录模式,该模式仅记录重放必不可少的信息- 同步
- 异步
context = browser.new_context(record_har_mode="minimal", record_har_path="har.har")
context = await browser.new_context(record_har_mode="minimal", record_har_path="har.har")
-
Playwright 现在在 Ubuntu 22 amd64 和 Ubuntu 22 arm64 上运行。
版本 1.22
亮点
-
角色选择器,允许通过 ARIA 角色、ARIA 属性 和 可访问名称 选择元素。
# Click a button with accessible name "log in"
page.locator("role=button[name='log in']").click()在 我们的文档 中阅读更多内容。
-
新的 locator.filter() API 用于过滤现有定位器
buttons = page.locator("role=button")
# ...
submit_button = buttons.filter(has_text="Submit")
submit_button.click() -
Codegen 现在支持生成 Pytest 测试
版本 1.21
亮点
-
新的角色选择器,允许通过 ARIA 角色、ARIA 属性 和 可访问名称 选择元素。
- 同步
- 异步
# Click a button with accessible name "log in"
page.locator("role=button[name='log in']").click()# Click a button with accessible name "log in"
await page.locator("role=button[name='log in']").click()在 我们的文档 中阅读更多内容。
-
page.screenshot() 中用于较小尺寸屏幕截图的新
scale
选项。 -
page.screenshot() 中用于控制文本光标的新
caret
选项。默认为"hide"
。
行为变更
mcr.microsoft.com/playwright
docker 镜像不再包含 Python。请使用mcr.microsoft.com/playwright/python
作为预装 Python 的 Playwright-ready docker 镜像。- Playwright 现在支持通过 locator.set_input_files() API 上传大文件(数百 MB)。
浏览器版本
- Chromium 101.0.4951.26
- Mozilla Firefox 98.0.2
- WebKit 15.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 100
- Microsoft Edge 100
版本 1.20
亮点
- 方法 page.screenshot()、locator.screenshot() 和 element_handle.screenshot() 的新选项
- 选项
animations: "disabled"
将所有 CSS 动画和过渡倒回到一致的状态 - 选项
mask: Locator[]
遮罩给定元素,用粉红色#FF00FF
框覆盖它们。
- 选项
- 跟踪查看器 现在显示 API 测试请求。
- locator.highlight() 以可视化方式显示元素,以便于调试。
公告
- 我们现在发布指定的 Python docker 镜像
mcr.microsoft.com/playwright/python
。如果您使用 Python,请切换到它。这是最后一个在我们的 javascriptmcr.microsoft.com/playwright
docker 镜像中包含 Python 的版本。 - v1.20 是最后一个接收 macOS 10.15 Catalina WebKit 更新的版本。请更新 macOS 以继续使用最新和最好的 WebKit!
浏览器版本
- Chromium 101.0.4921.0
- Mozilla Firefox 97.0.1
- WebKit 15.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 99
- Microsoft Edge 99
版本 1.19
亮点
-
定位器现在支持
has
选项,以确保它包含另一个定位器在内部- 同步
- 异步
page.locator("article", has=page.locator(".highlight")).click()
await page.locator("article", has=page.locator(".highlight")).click()
在 定位器文档 中阅读更多内容
-
新的 locator.page
-
page.screenshot() 和 locator.screenshot() 现在自动隐藏闪烁的光标
-
Playwright Codegen 现在生成定位器和 frame 定位器
浏览器版本
- Chromium 100.0.4863.0
- Mozilla Firefox 96.0.1
- WebKit 15.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 98
- Microsoft Edge 98
版本 1.18
API 测试
Playwright for Python 1.18 引入了新的 API 测试,让您可以直接从 Python 向服务器发送请求!现在您可以
- 测试您的服务器 API
- 在测试中访问 Web 应用程序之前准备服务器端状态
- 在浏览器中运行一些操作后,验证服务器端后置条件
要代表 Playwright Page 执行请求,请使用 新的 page.request API
- 同步
- 异步
# Do a GET request on behalf of page
res = page.request.get("http://example.com/foo.json")
# Do a GET request on behalf of page
res = await page.request.get("http://example.com/foo.json")
在 我们的文档 中阅读更多内容。
Web-First 断言
Playwright for Python 1.18 引入了 Web-First 断言。
考虑以下示例
- 同步
- 异步
from playwright.sync_api import Page, expect
def test_status_becomes_submitted(page: Page) -> None:
# ..
page.locator("#submit-button").click()
expect(page.locator(".status")).to_have_text("Submitted")
from playwright.async_api import Page, expect
async def test_status_becomes_submitted(page: Page) -> None:
# ..
await page.locator("#submit-button").click()
await expect(page.locator(".status")).to_have_text("Submitted")
Playwright 将重新测试具有选择器 .status
的节点,直到获取的节点具有 "Submitted"
文本。它将反复重新获取节点并检查它,直到满足条件或达到超时时间。您可以将此超时时间作为选项传递。
在 我们的文档 中阅读更多内容。
定位器改进
-
现在每个定位器都可以选择性地按其包含的文本进行过滤
- 同步
- 异步
page.locator("li", has_text="my item").locator("button").click()
await page.locator("li", has_text="my item").locator("button").click()
在 定位器文档 中阅读更多内容
新 API 和更改
accept_downloads
选项现在默认为True
。sources
选项将源嵌入到跟踪中。
浏览器版本
- Chromium 99.0.4812.0
- Mozilla Firefox 95.0
- WebKit 15.4
此版本还针对以下稳定通道进行了测试
- Google Chrome 97
- Microsoft Edge 97
版本 1.17
Frame 定位器
Playwright 1.17 引入了 frame 定位器 - 页面上 iframe 的定位器。Frame 定位器捕获了检索 iframe
然后在该 iframe 中定位元素的充分逻辑。Frame 定位器默认是严格的,将等待 iframe
出现,并且可以在 Web-First 断言中使用。
可以使用 page.frame_locator() 或 locator.frame_locator() 方法创建 Frame 定位器。
locator = page.frame_locator("my-frame").locator("text=Submit")
locator.click()
在 我们的文档 中阅读更多内容。
跟踪查看器更新
Playwright 跟踪查看器现在在线可用,网址为 https://trace.playwright.dev!只需拖放您的 trace.zip
文件即可检查其内容。
注意:跟踪文件不会上传到任何地方;trace.playwright.dev 是一个 渐进式 Web 应用程序,可在本地处理跟踪。
- Playwright Test 跟踪现在默认包含源(可以使用跟踪选项关闭这些源)
- 跟踪查看器现在显示测试名称
- 带有浏览器详细信息的新跟踪元数据选项卡
- 快照现在具有 URL 栏
HTML 报告更新
- HTML 报告现在支持动态过滤
- 报告现在是单个静态 HTML 文件,可以通过电子邮件或作为 slack 附件发送。
Ubuntu ARM64 支持 + 更多
-
Playwright 现在支持 Ubuntu 20.04 ARM64。您现在可以在 Apple M1 和 Raspberry Pi 上的 Docker 内部运行 Playwright 测试。
-
您现在可以使用 Playwright 在 Linux 上安装稳定版本的 Edge
npx playwright install msedge
新 API
版本 1.16
🎭 Playwright 库
locator.wait_for
等待定位器解析为具有给定状态的单个元素。默认为 state: 'visible'
。
在处理列表时尤其方便
order_sent = page.locator("#order-sent")
order_sent.wait_for()
阅读有关 locator.wait_for() 的更多信息。
Arm64 的 Docker 支持
Playwright Docker 镜像现在为 Arm64 发布,因此可以在 Apple Silicon 上使用。
阅读有关 Docker 集成 的更多信息。
🎭 Playwright 跟踪查看器
- 使用
npx playwright show-trace
运行跟踪查看器,并将跟踪文件拖放到跟踪查看器 PWA - 更好地视觉归因操作目标
阅读有关 跟踪查看器 的更多信息。
浏览器版本
- Chromium 97.0.4666.0
- Mozilla Firefox 93.0
- WebKit 15.4
此版本的 Playwright 也针对以下稳定通道进行了测试
- Google Chrome 94
- Microsoft Edge 94
版本 1.15
🖱️ 鼠标滚轮
通过使用 mouse.wheel(),您现在可以垂直或水平滚动。
📜 新的 Headers API
以前不可能获取响应的多个标头值。现在可以了,并且提供了其他辅助函数
- request.all_headers()
- request.headers_array()
- request.header_value()
- response.all_headers()
- response.headers_array()
- response.header_value()
- response.header_values()
🌈 Forced-Colors 模拟
现在可以通过在 browser.new_context() 中传递或调用 page.emulate_media() 来模拟 forced-colors
CSS 媒体功能。
新 API
- page.route() 接受新的
times
选项来指定此路由应匹配多少次。 - 引入了 page.set_checked() 和 locator.set_checked() 来设置复选框的选中状态。
- request.sizes() 返回给定 http 请求的资源大小信息。
- tracing.start_chunk() - 启动新的跟踪块。
- tracing.stop_chunk() - 停止新的跟踪块。
浏览器版本
- Chromium 96.0.4641.0
- Mozilla Firefox 92.0
- WebKit 15.0
版本 1.14
⚡️ 新的“严格”模式
选择器歧义是自动化测试中的常见问题。“严格”模式确保您的选择器指向单个元素,否则会抛出错误。
将 strict=true
传递到您的操作调用中以选择加入。
# This will throw if you have more than one button!
page.click("button", strict=True)
📍 新的 Locators API
Locator 代表页面上元素(或多个元素)的视图。它捕获了在任何给定时刻检索元素所需的逻辑。
Locator 和 ElementHandle 之间的区别在于,后者指向特定的元素,而 Locator 捕获了如何检索该元素的逻辑。
此外,locator 默认是 “strict” 的!
locator = page.locator("button")
locator.click()
在文档中了解更多信息。
🧩 实验性 React 和 Vue 选择器引擎
React 和 Vue 选择器允许通过组件名称和/或属性值选择元素。语法与 attribute selectors 非常相似,并支持所有属性选择器运算符。
page.locator("_react=SubmitButton[enabled=true]").click()
page.locator("_vue=submit-button[enabled=true]").click()
在 react selectors 文档 和 vue selectors 文档 中了解更多信息。
✨ 新的 nth
和 visible
选择器引擎
# select the first button among all buttons
button.click("button >> nth=0")
# or if you are using locators, you can use first, nth() and last
page.locator("button").first.click()
# click a visible button
button.click("button >> visible=true")
浏览器版本
- Chromium 94.0.4595.0
- Mozilla Firefox 91.0
- WebKit 15.0
版本 1.13
Playwright
- 🖖 程序化拖放支持,通过 page.drag_and_drop() API。
- 🔎 增强的 HAR,包含请求和响应的 body 大小。通过 browser.new_context() 中的
recordHar
选项使用。
工具
- Playwright Trace Viewer 现在显示参数、返回值和
console.log()
调用。
新的和经过修改的指南
浏览器版本
- Chromium 93.0.4576.0
- Mozilla Firefox 90.0
- WebKit 14.2
新的 Playwright API
baseURL
选项,位于 browser.new_context() 和 browser.new_page() 中- response.security_details() 和 response.server_addr()
- page.drag_and_drop() 和 frame.drag_and_drop()
- download.cancel()
- page.input_value(), frame.input_value() 和 element_handle.input_value()
force
选项,位于 page.fill(), frame.fill(), 和 element_handle.fill() 中force
选项,位于 page.select_option(), frame.select_option(), 和 element_handle.select_option() 中
版本 1.12
🧟♂️ 隆重推出 Playwright Trace Viewer
Playwright Trace Viewer 是一个新的 GUI 工具,可帮助在脚本运行后浏览记录的 Playwright 跟踪。Playwright 跟踪使您可以检查
- 每个 Playwright 操作之前和之后的页面 DOM
- 每个 Playwright 操作之前和之后的页面渲染
- 脚本执行期间的浏览器网络
跟踪是使用新的 browser_context.tracing API 记录的
browser = chromium.launch()
context = browser.new_context()
# Start tracing before creating / navigating a page.
context.tracing.start(screenshots=True, snapshots=True)
page.goto("https://playwright.net.cn")
# Stop tracing and export it into a zip archive.
context.tracing.stop(path = "trace.zip")
稍后使用 Playwright CLI 检查跟踪
playwright show-trace trace.zip
这将打开以下 GUI
👉 在 trace viewer 文档 中阅读更多信息。
浏览器版本
- Chromium 93.0.4530.0
- Mozilla Firefox 89.0
- WebKit 14.2
此版本的 Playwright 也针对以下稳定通道进行了测试
- Google Chrome 91
- Microsoft Edge 91
新 API
reducedMotion
选项,位于 page.emulate_media(), browser_type.launch_persistent_context(), browser.new_context() 和 browser.new_page() 中- browser_context.on("request")
- browser_context.on("requestfailed")
- browser_context.on("requestfinished")
- browser_context.on("response")
tracesDir
选项,位于 browser_type.launch() 和 browser_type.launch_persistent_context() 中- 新的 browser_context.tracing API 命名空间
- 新的 download.page 方法
版本 1.11
🎥 新视频:Playwright: A New Test Automation Framework for the Modern Web (幻灯片)
- 我们讨论了 Playwright
- 展示了幕后的工程工作
- 进行了新功能的现场演示 ✨
- 特别感谢 applitools 主办本次活动并邀请我们!
浏览器版本
- Chromium 92.0.4498.0
- Mozilla Firefox 89.0b6
- WebKit 14.2
新 API
- 支持 异步断言,API 中如 page.expect_request() 等方法。
- 新的 模拟设备:Galaxy S8, Galaxy S9+, Galaxy Tab S4, Pixel 3, Pixel 4
- 新方法
- page.wait_for_url() 用于等待导航到 URL
- video.delete() 和 video.save_as() 用于管理屏幕录制
- 新选项
screen
选项,位于 browser.new_context() 方法中,用于模拟window.screen
尺寸position
选项,位于 page.check() 和 page.uncheck() 方法中trial
选项,用于在 page.check(), page.uncheck(), page.click(), page.dblclick(), page.hover() 和 page.tap() 中试运行操作
版本 1.10
- Playwright for Java v1.10 现已稳定!
- 通过 新的 channels API,针对 Google Chrome 和 Microsoft Edge 稳定通道运行 Playwright。
- Chromium 屏幕截图在 Mac 和 Windows 上速度很快。
捆绑的浏览器版本
- Chromium 90.0.4430.0
- Mozilla Firefox 87.0b10
- WebKit 14.2
此版本的 Playwright 也针对以下稳定通道进行了测试
- Google Chrome 89
- Microsoft Edge 89
新 API
- browser_type.launch() 现在接受新的
'channel'
选项。在 我们的文档 中阅读更多信息。
版本 1.9
- Playwright Inspector 是一个 新的 GUI 工具,用于编写和调试您的测试。
- 逐行调试 您的 Playwright 脚本,具有播放、暂停和单步执行功能。
- 通过记录用户操作来编写新脚本。
- 通过悬停在元素上,为您的脚本生成元素选择器。
- 设置
PWDEBUG=1
环境变量以启动 Inspector
- 在有头模式下使用 page.pause() 暂停脚本执行。暂停页面会启动 Playwright Inspector 以进行调试。
- CSS 选择器的新的 has-text 伪类。
:has-text("example")
匹配任何在其内部(可能在子元素或后代元素中)包含"example"
的元素。请参阅 更多示例。 - 页面对话框现在在执行期间自动关闭,除非配置了
dialog
事件的监听器。 了解更多关于此内容。 - Playwright for Python 现已稳定,具有惯用的蛇形命名 API 和预构建的 Docker 镜像,用于在 CI/CD 中运行测试。
浏览器版本
- Chromium 90.0.4421.0
- Mozilla Firefox 86.0b10
- WebKit 14.1
新 API
版本 1.8
-
使用
:left-of()
,:right-of()
,:above()
和:below()
基于布局选择元素。 -
Playwright 现在包含命令行界面,即之前的 playwright-cli。
playwright --help
-
page.select_option() 现在等待选项出现。
-
新方法来断言元素状态,例如 page.is_editable()。
新 API
- element_handle.is_checked().
- element_handle.is_disabled().
- element_handle.is_editable().
- element_handle.is_enabled().
- element_handle.is_hidden().
- element_handle.is_visible().
- page.is_checked().
- page.is_disabled().
- page.is_editable().
- page.is_enabled().
- page.is_hidden().
- page.is_visible().
editable
新选项,位于 element_handle.wait_for_element_state() 中。
浏览器版本
- Chromium 90.0.4392.0
- Mozilla Firefox 85.0b5
- WebKit 14.1
版本 1.7
- 新的 Java SDK:Playwright for Java 现在与 JavaScript, Python 和 .NET bindings 处于同等水平。
- 浏览器存储 API:新的便捷 API,用于保存和加载浏览器存储状态(cookies、本地存储),以简化具有身份验证的自动化场景。
- 新的 CSS 选择器:我们听取了您对更灵活选择器的反馈,并改进了选择器实现。Playwright 1.7 引入了 新的 CSS 扩展,并且即将推出更多。
- 新网站:playwright.dev 的文档网站已更新,现在使用 Docusaurus 构建。
- 支持 Apple Silicon:WebKit 和 Chromium 的 Playwright 浏览器二进制文件现在为 Apple Silicon 构建。
新 API
- browser_context.storage_state() 获取当前状态以便稍后重用。
storageState
选项,位于 browser.new_context() 和 browser.new_page() 中,用于设置浏览器上下文状态。
浏览器版本
- Chromium 89.0.4344.0
- Mozilla Firefox 84.0b9
- WebKit 14.1