Harness 与 Agent 工程 · 运行控制与长任务 · 2026-05-22

Playwright 1.59 新特性:3 个 API 帮你告别 F12 手动找定位

Playwright 1.59 发布三大定位器新API,让你彻底告别F12手动查找的繁琐流程。

核心内容:

  1. 三大新API(pickLocator、normalize、screencast)的实战应用
  2. 批量清洗项目定位器的自动化工具
  3. 结合AI自动生成Page Object骨架的Prompt模板

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
    1. data-test:专门给测试预留,最稳
    1. role:语义化定位,可访问性友好
    1. text:文本定位,够直观
    1. test_id:Playwright 内置测试属性
    1. CSS:通用兜底
    1. XPath:万不得已

下面三个 API,本质上是帮你在执行层更快地落地这套优先级框架。


二、3 个 API 更新

2.1 page.pickLocator() —— 指哪儿点哪儿

这是 1.59 对测试人员最友好的功能。

以前怎么找定位器?(以 saucedemo.com 登录页为例)

    1. 打开 https://www.saucedemo.com
    1. F12 → 审查元素
    1. 在密密麻麻的 DOM 里找到用户名输入框
    1. 看到一个 <input id="user-name" ...>
    1. 写 #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() 按优先级检查:

    1. 有没有 data-test 属性?→ 有,直接用 getByTestId()
    1. 有没有 role?→ 有,用 getByRole()
    1. 有没有 aria-label / placehold…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/tishicijiqiao/2026052270924.html