【playwright篇】page.query_selector() / ElementHandle 对象方法讲解

page.query_selector() 方法

返回值

返回的是一个 ElementHandle 对象

该对象代表了页面上找到的第一个匹配元素。这个 ElementHandle 对象提供了多种方法来与页面上的元素进行交互，例如点击、填写表单字段等。

Playwright 提供了一个 ElementHandle 类来代表页面上单个 DOM 元素的句柄。ElementHandle 提供了一系列方法来与页面上的元素进行交互，包括点击、填写表单字段、获取属性值等。

下面是 ElementHandle 的一些常用方法及其简要说明：

1. elementHandle.boundingBox()

• 功能：获取元素的边界框位置和尺寸。
• 返回：一个包含 {x, y, width, height} 的对象，如果元素不在视图内则返回 null。

2. elementHandle.click(options)

• 功能：模拟点击事件。
• 参数：options 是一个可选的对象，可以设置点击的位置、点击次数等。

3. elementHandle.dblclick(options)

• 功能：模拟双击事件。
• 参数：options 是一个可选的对象，可以设置点击的位置等。

4. elementHandle.hover()

• 功能：模拟鼠标悬停事件。

5. elementHandle.textContent()

• 功能：获取元素的文本内容。
• 返回：元素的文本内容作为字符串。

6. elementHandle.innerText()

• 功能：获取元素的内部文本。
• 返回：元素的内部文本作为字符串。

7. elementHandle.getAttribute(name)

• 功能：获取元素的属性值。
• 参数：name 是属性名。
• 返回：属性值作为字符串，如果不存在则返回 null。

8. elementHandle.fill(value)

• 功能：填充表单字段。
• 参数：value 是要填入的值。

9. elementHandle.type(text, options)

• 功能：模拟键盘输入。
• 参数：text 是要输入的文本；options 可以包含延迟等选项。

10. elementHandle.press(key, options)

• 功能：模拟按键按下和释放。
• 参数：key 是要按下的键；options 可以包含延迟等选项。

11. elementHandle.evaluate(pageFunction, ...args)

• 功能：在页面上下文中执行函数。
• 参数：pageFunction 是在页面上下文中执行的函数；...args 是传递给 pageFunction 的参数。

12. elementHandle.screenshot(options)

• 功能：对元素进行截图。
• 参数：options 包含截图的各种选项，如路径、质量等。

13. elementHandle.boxModel()

• 功能：获取元素的盒模型信息。
• 返回：一个包含元素盒模型信息的对象。

14. elementHandle.dispose()

• 功能：释放 ElementHandle。

15. elementHandle.contentFrame()

• 功能：获取元素所在的 Frame。
• 返回：Frame 对象，如果元素不在任何帧中，则返回 null。

16. elementHandle.isIntersectingViewport()

• 功能：检查元素是否与视口相交。
• 返回：布尔值，如果元素与视口相交则为 true。

17. elementHandle.isVisible()

• 功能：检查元素是否可见。
• 返回：布尔值，如果元素可见则为 true。

18. elementHandle.isEditable()

• 功能：检查元素是否可编辑。
• 返回：布尔值，如果元素可编辑则为 true。

19. elementHandle.isDisabled()

• 功能：检查元素是否被禁用。
• 返回：布尔值，如果元素被禁用则为 true。

20. elementHandle.isDetached()

• 功能：检查元素是否从 DOM 中移除。
• 返回：布尔值，如果元素已从 DOM 中移除则为 true。

21. elementHandle.waitForFunction(pageFunction, options, ...args)

• 功能：等待指定条件满足。
• 参数：pageFunction 是在页面上下文中执行的函数；options 可以包含超时等选项；...args 是传递给 pageFunction 的参数。

22. elementHandle.waitForSelector(selector, options)

• 功能：等待子元素出现。
• 参数：selector 是子元素的选择器；options 可以包含超时等选项。

23. elementHandle.waitForXPath(xpath, options)

• 功能：等待子元素通过 XPath 出现。
• 参数：xpath 是 XPath 表达式；options 可以包含超时等选项。

以上就是 ElementHandle 中一些常用的 API 方法。请注意，这些方法的具体实现可能会随 Playwright 版本的不同而略有差异。建议参考最新的文档以获取最准确的信息。