|--------------|--------------------------|--------------------------|-------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
| 命令分类 | 命令名 | 核心作用 | 参数说明 | 示例 | 注意事项 |
| 页面基础操作 | Open | 打开指定 URL | Target:完整 URL(必填)Value:留空 | Open / https://www.baidu.com / - | URL 必须带 http/https 协议,不能省略 |
| 页面基础操作 | Set Window Size | 设置浏览器窗口大小 | Target:留空Value:宽 x 高(如 1920x1080,必填) | Set Window Size / - / 1314x1040 | Value 格式为「数字 x 数字」,无空格 |
| 页面基础操作 | Click | 点击元素(按钮 / 链接 / 下拉框等) | Target:元素定位器(id/xpath/css,必填)Value:留空 | Click / id=chat-submit-button / -Click /xpath=//button [text ()=' 搜索 '] /- | 点击前建议加 Wait for Element Present,确保元素加载 |
| 页面基础操作 | Send Keys | 向输入框输入文本(替代 Type 命令) | Target:输入框定位器(必填)Value:要输入的文本(必填) | Send Keys /id=chat-textarea / 你好世界 | 输入前可先 Click 激活输入框,避免输入无效 |
| 页面基础操作 | Clear | 清空输入框内容(部分版本无) | Target:输入框定位器(必填)Value:留空 | Clear / id=chat-textarea / - | 无此命令时,用 Send Keys 发送 {KEY_CTRL+a} + {KEY_BACKSPACE} 替代 |
| 变量复用 | Store | 定义变量(替代 Set Variable) | Target:变量值(必填)Value:变量名(必填) | Store / 你好世界 /search_textStore / id=chat-textarea / input_loc | 调用变量用 {变量名},如 {search_text} |
| 变量复用 | Run Test Case | 调用其他测试用例(实现复用) | Target:被调用的用例名(必填,需同名)Value:留空 | Run Test Case / common_search / - | 调用的用例需和当前用例在同一测试套件中 |
| 断言 / 验证 | Assert Element Present | 断言元素存在(失败终止用例) | Target:元素定位器(必填)Value:留空 | Assert Element Present /xpath=//h3 [contains (.,' 你好世界 ')] /- | 断言前必须加 Wait for Element Present |
| 断言 / 验证 | Verify Element Present | 验证元素存在(失败仅警告,不终止) | Target:元素定位器(必填)Value:留空 | Verify Element Present /xpath=//h3 [contains (.,' 你好世界 ')] /- | 非核心元素校验优先用 Verify 替代 Assert |
| 断言 / 验证 | Assert Text | 断言元素文本完全匹配 | Target:元素定位器(必填)Value:预期文本(必填) | Assert Text /xpath=//h3 [@class='title'] / 你好世界 - 百度百科 | 文本需完全一致(包括空格 / 符号),容错率低 |
| 断言 / 验证 | Verify Text Contains | 验证元素文本包含指定内容(容错率高) | Target:元素定位器(必填)Value:要包含的文本(必填) | Verify Text Contains /xpath=//h3 [@class='title'] / 你好世界 | 推荐用于文本校验,避免因格式差异失败 |
| 等待 / 控制 | Wait for Element Present | 等待元素出现(超时失败) | Target:元素定位器(必填)Value:等待时长(毫秒,如 5000,必填) | Wait for Element Present /xpath=//h3 [contains (.,' 你好世界 ')] / 5000 | 所有点击 / 输入 / 断言前必加,解决元素加载延迟(最核心) |
| 等待 / 控制 | Wait for Page Load | 等待页面完全加载(如跳转后) | Target:留空Value:等待时长(毫秒,如 10000,必填) | Wait for Page Load / - / 10000 | 仅用于页面跳转场景,优先用 Wait for Element Present 替代 |
| 等待 / 控制 | Pause | 强制暂停用例执行(临时调试) | Target:留空Value:暂停时长(毫秒,如 2000,必填) | Pause / - / 2000 | 不推荐长期使用,仅临时调试用 |
| 进阶扩展 | Execute Script | 执行 JavaScript 脚本(实现复杂操作) | Target:JS 脚本(必填)Value:变量名(可选,存储返回值) | Execute Script / window.scrollTo(0, document.body.scrollHeight) / -Execute Script / return document.getElementById('chat-textarea').value / input_value | 可实现 IDE 原生命令无法完成的操作(如滚动、获取复杂属性) |
| 进阶扩展 | Store Text | 把元素文本存为变量 | Target:元素定位器(必填)Value:变量名(必填) | Store Text / xpath=//h3[@class='title'] / result_text | 仅能获取元素的「可见文本」,无法获取隐藏文本 |
| 进阶扩展 | Store Attribute | 把元素属性值存为变量 | Target:元素定位器 @属性名(必填,如 id=chat-textarea@value)Value:变量名(必填) | Store Attribute / id=chat-textarea@value / input_value | 支持所有 HTML 属性(value/class/id 等) |
selenium IDE——command
xixi09242026-02-26 10:18