命令分类

命令名

核心作用

参数说明

示例

注意事项

页面基础操作

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 等）