click_element
Click web page elements using optimized selectors for browser automation. Follow structured workflows: confirm element existence with screenshots, analyze DOM structure, then execute clicks based on verified selectors.
Instructions
点击页面元素(智能优化版)
⚠️ 重要提示:使用此工具前,请务必遵循标准化工作流程:
1. 📸 先使用 take_screenshot() 确认目标元素存在
2. 🔍 使用 get_dom_tree() 或 find_elements() 分析页面结构
3. 🎯 基于准确信息构建选择器,禁止猜测元素名称
🎯 选择器优先级(推荐顺序):
- ID选择器:#element-id (最优先)
- CSS类选择器:.class-name
- 属性选择器:[data-testid="value"]
- XPath选择器://div[@class="example"]
- 文本匹配:仅作为辅助手段
Args:
selector: 元素选择器(禁止猜测,必须基于实际DOM结构)
selector_type: 选择器类型 (css, xpath, text)
index: 元素索引(当有多个匹配时,从0开始)
smart_feedback: 是否启用智能反馈(推荐True)
Returns:
str: 操作结果和反馈信息
💡 最佳实践示例:
- 正确:先 find_elements("button") 确认按钮存在,再 click_element("#submit-btn")
- 错误:直接 click_element("#可能存在的按钮") 而不确认元素
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| selector | Yes | ||
| selector_type | No | css | |
| index | No | ||
| smart_feedback | No |