Playwright 弹窗里有多个同名按钮,怎么避免点错?
要删除订单 `A123`。这时右侧还开着编辑抽屉,背景筛选区也没消失。屏幕上三个“确定”,分别用来**提交筛选、保存编辑、确认删除**。看一眼弹窗标题和订单号,人就知道应该点中间那个红色按钮。

*图为订单管理演示页的浏览器截图,使用模拟数据。左侧蓝色按钮用于筛选,右下角蓝色按钮用于保存编辑,中间红色按钮用于删除 A123。*
如果脚本写的是 `page.getByRole('button', { name: '确定', exact: true }).click()`,查找范围就是整个页面。在这个演示页里,这个定位器命中三个元素。`click()` 要求目标唯一,因此会报 `strict mode violation`。 [Playwright 的 Locator 严格模式](https://playwright.dev/docs/locators#strictness)
## 先认准订单,再把定位限制在删除确认框里
`exact: true` 要求名称精确匹配,三个同名按钮依然符合条件。`.first()` 和 `.nth()` 只表达匹配顺序。抽屉关闭或页面结构调整后,这个位置就可能指向另一个操作。
把人做判断时用到的信息写进定位和断言就清楚了。先在订单表格中找到订单号为 `A123` 的行,从这一行点“删除”。等名称为“删除订单”的网页弹窗出现后,确认正文中的订单号。最后,在**这个弹窗的范围内**找“确定”。
下面的代码放在 Playwright Test 的测试函数中,假设已导入 `expect`,`page` 已打开订单列表。示例先打开编辑抽屉,以复现截图中的三个同名按钮。弹窗通过 `aria-labelledby` 关联标题,筛选表单通过 `data-testid` 识别。每轮应准备一条可删除的测试订单,演示页刷新后会恢复 `A123`。
```ts
const orderNo = 'A123';
const table = page.getByRole('table', { name: '订单列表' });
const orderRow = table.getByRole('row').filter({
has: page.getByRole('cell', { name: orderNo, exact: true }),
});
await expect(orderRow).toHaveCount(1);
await orderRow.getByRole('button', { name: '编辑', exact: true }).click();
await orderRow.getByRole('button', { name: '删除', exact: true }).click();
const confirmation = page.getByRole('dialog', { name: '删除订单', exact: true });
await expect(confirmation.getByText(orderNo, { exact: true })).toBeVisible();
await confirmation.getByRole('button', { name: '确定', exact: true }).click();
await expect(confirmation).toBeHidden();
const search = page.getByTestId('order-filter-form');
await search.getByLabel('订单号').fill(orderNo);
await search.getByRole('button', { name: '确定', exact: true }).click();
await expect(page.getByText('暂无匹配订单', { exact: true })).toBeVisible();
await expect(orderRow).toHaveCount(0);
```
这里有两次需要执行的“确定”。第一次只在删除弹窗里查找,第二次只在筛选表单里查找。最后在查询结果里检查 A123 已经消失。遇到异步查询的页面,先等**本次查询结果就绪**,再验证空结果和目标行。只断言行数为零,加载中也可能恰好通过。
如果页面的弹窗没有可访问名称,可以先用稳定测试标识限定容器,比如 `page.getByTestId('delete-order-dialog')`,再查容器中的订单号和按钮。
如果用的是 `window.confirm()`,应在触发前注册 Playwright 的 `dialog` 事件处理器。上面的 `getByRole('dialog')` 适用于网页 DOM 内的弹窗。 [Playwright 对话框文档](https://playwright.dev/docs/dialogs)
## 更好的方式
回演 CueCast 在内核级别就解决了该问题,通过一些策略来轻松地录制和回放用例。录制时,CueCast 会把按钮和所在区域一起录下来。回放这条流程时,CueCast 会先找到对应的订单,再确定弹窗范围,并检查点击能不能命中目标。
**先把“删除”绑定到对应的订单行。** 录制表格里的“删除”时,如果能提取唯一的业务标识,CueCast 可以保存这条订单的匹配条件。回放时,它会按订单号找到 `A123`,然后在这一行里找“删除”。**就算列表排序变了,操作仍跟着订单走**。采用“按业务对象”定位时,匹配不到或匹配到多行,步骤会停下来。
**匹配“确定”之前先缩小查找范围。** 录制弹窗内的点击时,CueCast 会保存按钮文本、元素语义、组件结构和所在区域,并保留 CSS、XPath 等备用定位线索。步骤带有可识别的弹窗路径时,回放会过滤掉隐藏的弹窗,再参考各容器的 `z-index` 选出当前最上层弹窗。按钮候选必须在这个容器内,因此背景筛选区和编辑抽屉里的同名按钮会被排除。
**点击前再确认指针会落到哪里。** 普通点击会根据当前页面计算目标位置,并用浏览器的 `elementFromPoint()` 检查点击点最上层的元素。命中按钮里的文字或图标时,仍然可以执行点击。如果该位置被浮层挡住,回放会在限定时间内重新检查。这一步解决的是“鼠标会点中谁”,弹窗里的订单号断言则用来核对“这次删的是谁”。

如果你的回归用例也经常遇到弹窗里的同名按钮,可以试试看使用回演 CueCast。录制时只需完成正常的页面操作,并选中要验证的信息。保存后,CueCast 会在每次回放中重新定位订单行和按钮。

筛选区、编辑抽屉和删除弹窗里都有“确定”,Playwright 点击时可能报 `strict mode violation`。以删除订单为例,先定位订单行,再把按钮查找范围缩小到删除弹窗,核对订单号后才点击。正文用一张演示后台实拍图和一段代码走完这条路径,并说明回演 CueCast 怎样把弹窗范围随操作一起录下来。
浙公网安备 33010602011771号