Playwright 1.59 三个定位器新 API,把「F12 翻 DOM→手动改 selector」的工作流变成「指哪儿点哪儿→自动规范化→AI 生成 PO 骨架」。 学完你会获得: ① 三个 API(pickLocator / normalize / screencast)的完整代码示例,saucedemo 实战可跑 ② 批量清洗现有项目定位器的工具脚本 ③ 结合 AI 自动生成 Page Object 的 Prompt 模板
帮你少走弯路哦少踩坑。
环境配置:安装与升级(Playwright v1.59)
新用户(从零开始):
## Python 版pip install playwrightplaywright install# Node.js 版npm init playwright@latest
老用户升级:
## Python 版pip install --upgrade playwrightplaywright install# Node.js 版npm install @playwright/test@latestnpx playwright install
Python 和 Node.js 都支持吗?
✅ pickLocator() — Python + Node.js 均支持
✅ locator.normalize() — Python + Node.js 均支持
✅ page.screencast — Python + Node.js 均支持
一、问题:1000+ 用例,定位器怎么写最快?
playwright 发布了最新的1.59版本,更新了不少内容,加强了AI Agent + 自动化测试。星主能不能介绍下具体的落地案例?
我现在还是F12一个一个的手动去写定位,有没有快速高效的案例,提升写用例的效率。现在已经维护了1000+的用例了。一个一个去找定位太慢了,虽然元素都加了testid了。 ..生成整个 PO 模式的脚本,只需要人工调试修改定位表达式。想实现这种效果
「太慢了。能不能把页面地址丢给 AI,让它直接生成整个 PO 脚本?」
这个问题,Playwright 1.59 给了三个直接对口的答案。
但在讲 API 之前,先把定位策略优先级重申一遍——这是地基:
data-test > role > text > test_id > CSS > XPath
-
- data-test:专门给测试预留,最稳
-
- role:语义化定位,可访问性友好
-
- text:文本定位,够直观
-
- test_id:Playwright 内置测试属性
-
- CSS:通用兜底
-
- XPath:万不得已
下面三个 API,本质上是帮你在执行层更快地落地这套优先级框架。
二、3 个 API 更新
2.1 page.pickLocator() —— 指哪儿点哪儿
这是 1.59 对测试人员最友好的功能。
以前怎么找定位器?(以 saucedemo.com 登录页为例)
-
- 打开 https://www.saucedemo.com
-
- F12 → 审查元素
-
- 在密密麻麻的 DOM 里找到用户名输入框
-
- 看到一个
<input id="user-name" ...>
- 看到一个
-
- 写
#user-name,心里默念「这 id 应该不会变吧...」
- 写
现在呢?一行代码:
locator = await page.pick_locator()
运行后浏览器进入选取模式——鼠标悬停到哪个元素,哪个高亮,旁边实时显示定位器表达式。点一下就选中,locator 对象直接返回。
实战:pickLocator 选取 saucedemo 登录页元素
import asynciofrom playwright.async_api import async_playwrightasync def main(): async with async_playwright() as p: browser = await p.chromium.launch(headless=False) page = await browser.new_page() await page.goto('https://www.saucedemo.com/', wait_until='networkidle') print('\n>>> 请在浏览器中点击「用户名输入框」') username_loc = await page.pick_locator() username_loc = await username_loc.normalize() print(f'✅ 用户名输入框 → {username_loc}') print('\n>>> 请点击「密码输入框」') password_loc = await page.pick_locator() password_loc = await password_loc.normalize() print(f'✅ 密码输入框 → {password_loc}') print('\n>>> 请点击「登录按钮」') login_btn = await page.pick_locator() login_btn = await login_btn.normalize() print(f'✅ 登录按钮 → {login_btn}') await browser.close()asyncio.run(main())
运行这个脚本,你会在浏览器里点三个元素,终端立刻打印出三个已经规范化的定位器。
2.2 locator.normalize() —— 把烂定位器洗成最佳实践
上一个例子已经顺带演示了 normalize。这里单独展开讲讲它到底做了什么。
saucedemo 举例:商品页的按钮
saucedemo 的商品列表页,每个商品都有「ADD TO CART」按钮,HTML 长这样:
<button class="btn btn_primary btn_small btn_inventory" data-test="add-to-cart-sauce-labs-backpack"> Add to cart</button>
如果你手头有一段历史代码,用 CSS class 定位了这个按钮:
add_to_cart_btn = page.locator('.btn_inventory')
问题在于 .btn_inventory 这个 class 在页面里有 6 个(6 个商品各一个),会匹配到第一个,不稳定。
用 normalize 一键升级:
raw = page.locator('.btn_inventory')best = await raw.normalize()print(best) # getByTestId('add-to-cart-sauce-labs-backpack')
normalize() 按优先级检查:
-
- 有没有
data-test属性?→ 有,直接用getByTestId()
- 有没有
-
- 有没有
role?→ 有,用getByRole()
- 有没有
-
- 有没有
aria-label/placehold…
- 有没有