find_elements
Locate web page elements using CSS selectors, XPath, or text matching to verify existence, accessibility, and retrieve detailed attributes for browser automation tasks.
Instructions
查找页面元素(智能定位工具)
⚠️ 精确定位工具:基于DOM分析结果进行元素查找!
🎯 主要用途:
1. 🔍 基于get_dom_tree()结果,精确定位目标元素
2. 📋 验证元素存在性和可访问性
3. 🎯 获取元素的详细属性信息(id、class、text等)
4. 🛠️ 为后续操作提供准确的选择器
💡 选择器类型优先级:
1. CSS选择器:#id、.class、[attribute](推荐)
2. XPath://div[@class='example'](复杂定位)
3. 文本匹配:"按钮文字"(辅助手段)
Args:
selector: 元素选择器(必须基于实际DOM结构)
selector_type: 选择器类型(css/xpath/text)
limit: 返回元素数量限制(避免结果过多)
include_similar: 是否包含相似元素(智能匹配)
Returns:
str: 匹配元素的详细信息列表
🚀 最佳实践:
- 先用get_dom_tree()分析页面结构
- 基于结构信息构建精确选择器
- 验证找到的元素是否为目标元素
- 将结果用于click_element()或input_text()操作
Returns:
str: 查找结果
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| selector | Yes | ||
| selector_type | No | css | |
| limit | No | ||
| include_similar | No |