Windows环境下Playwright TypeScript获取元素文本异常排查

1. 核心问题：你断言的是元素对象，不是文本内容 #

说白了就是你没从定位到的标题元素里把文本抽出来，直接对着Playwright返回的元素句柄/定位器对象做断言了。

Playwright里，不管用page.locator('选择器')还是page.$('选择器')定位元素，返回的都是个元素对象，不是字符串。你直接断言这个对象，输出的肯定是Playwright内部对元素的封装结构（里面自带Frame相关的元数据属性，哪怕页面没Frame，这是Playwright元素对象的固有属性），不可能是你要的标题文本。

举个错误代码的例子：

// 错在这儿：直接断言locator对象
await expect(page.locator('h1')).toBe('Welcome to Restful Booker Platform');

2. 为啥会看到Frame相关的输出？ #

Playwright的元素对象（ElementHandle/Locator）内部会存一些元数据，比如元素所属的执行上下文、关联的Frame信息之类的——哪怕当前页面没有Frame，这些属性也会存在，只是值是null或者默认状态。当你打印或断言这个对象时，这些内部属性就会被显示出来，让你误以为和页面Frame有关，但实际上跟页面结构半毛钱关系没有。

正确的做法 #

得从元素里把文本提取出来再断言，或者用Playwright自带的断言方法直接校验文本：

方法1：用Locator的toHaveText断言（推荐） #

Playwright的expect库支持直接对定位器做文本断言，不用手动抽文本：

await expect(page.locator('h1')).toHaveText('Welcome to Restful Booker Platform');

方法2：手动提取文本后断言 #

如果需要先拿到文本做其他处理，就调用.textContent()或者.innerText()：

const titleText = await page.locator('h1').textContent();
await expect(titleText).toBe('Welcome to Restful Booker Platform');

提示：.textContent()会返回元素里所有文本（包括隐藏的），.innerText()只返回可见文本，根据你测试的需求选就行。

内容的提问来源于stack exchange，提问作者Raisus