Playwright如何检查Locator仅返回1个元素？

你遇到的问题是因为Playwright的Locator是定位器对象，而非直接的元素数组，所以无法直接用toHaveLength断言它的长度。要实现检查匹配元素数量为1的需求，有两种常用方法：

方法一：使用Playwright内置的toHaveCount匹配器（推荐） #

这是官方推荐的方式，直接对定位器进行断言：

await expect(page.getByRole('option')).toHaveCount(1);

方法二：手动获取元素计数后断言 #

先调用定位器的count()方法获取匹配元素的数量，再用普通断言验证：

const optionCount = await page.getByRole('option').count();
expect(optionCount).toBe(1);

补充说明 #

getByRole返回的Locator是延迟执行的定位器，它不会立即查询DOM元素，而是在执行操作（如count()、click()）或断言时才会去查找元素，因此它本身没有length属性，这就是你之前报错的原因。

内容的提问来源于stack exchange，提问作者No Idea For Name