命令
add selection
将选择添加到多选元素中的选项集中。
参数
answer on next prompt
影响下一个警报提示。此命令将向其发送指定的答案字符串。如果警报已存在,则改用“webdriver answer on visible prompt”。
参数
- 答案:对提示弹出窗口的响应答案。
assert
检查变量是否为预期值。变量的值将转换为字符串进行比较。如果断言失败,测试将停止。
参数
assert alert
确认已使用提供的文本呈现警报。如果断言失败,测试将停止。
参数
- 警报文本:要检查的文本
assert checked
确认目标元素已选中。如果断言失败,测试将停止。
参数
- 定位器:元素定位器。
assert confirmation
确认已呈现确认。如果断言失败,测试将停止。
参数
- 文本:要使用的文本。
assert editable
确认目标元素可编辑。如果断言失败,测试将停止。
参数
- 定位器:元素定位器。
assert element present
确认目标元素出现在页面上的某个位置。如果断言失败,测试将停止。
参数
- 定位器:元素定位器。
assert element not present
确认目标元素未出现在页面上的任何位置。如果断言失败,测试将停止。
参数
- 定位器:元素定位器。
assert not checked
确认目标元素尚未选中。如果断言失败,测试将停止。
参数
- 定位器:元素定位器。
assert not editable
确认目标元素不可编辑。如果断言失败,测试将停止。
参数
- 定位器:元素定位器。
assert not selected value
确认下拉元素中所选选项的 value 属性不包含提供的值。如果断言失败,测试将停止。
参数
select locator:一个元素定位器,用于识别下拉菜单。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
assert not text
确认元素的文本不包含提供的值。如果断言失败,测试将停止。
参数
定位器:元素定位器。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
assert prompt
确认已呈现 JavaScript 提示。如果断言失败,测试将停止。
参数
- 文本:要使用的文本。
assert selected value
确认下拉元素中所选选项的 value 属性包含提供的 value。如果断言失败,测试将停止。
参数
select locator:一个元素定位器,用于识别下拉菜单。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
assert selected label
确认下拉元素中所选选项的标签包含提供的 value。如果断言失败,测试将停止。
参数
select locator:一个元素定位器,用于识别下拉菜单。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
assert text
确认元素的文本包含提供的 value。如果断言失败,测试将停止。
参数
定位器:元素定位器。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
assert title
确认当前页面的标题包含提供的文本。如果断言失败,测试将停止。
参数
- text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
断言值
确认输入字段(或任何具有值参数的其他内容)的(修剪空格后的)值。对于复选框/单选按钮元素,值将是“on”或“off”,具体取决于元素是否被选中。如果断言失败,测试将停止。
参数
定位器:元素定位器。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
检查
选中一个切换按钮(复选框/单选按钮)。
参数
- 定位器:元素定位器。
在下一次确认时选择取消
影响下一次确认警报。此命令将取消它。如果警报已存在,请改用“webdriver 选择取消可见确认”。
选择在下一个提示中取消
影响下一个警报提示。此命令将取消它。如果警报已经存在,则改用“webdriver 选择在可见提示中取消”。
选择在下一个确认中确定
影响下一个确认警报。此命令将接受它。如果警报已经存在,则改用“webdriver 选择在可见确认中确定”。
单击
单击目标元素(例如,链接、按钮、复选框或单选按钮)。
参数
- 定位器:元素定位器。
点击
点击目标元素(例如,链接、按钮、复选框或单选按钮)。坐标相对于目标元素(例如,0,0 是元素的左上角),主要用于检查依赖于它们的特效,例如材料波纹效果。
参数
关闭
关闭当前窗口。无需关闭初始窗口,IDE 将重复使用它;关闭它可能会导致测试性能下降。
调试器
中断执行并进入调试器
执行
创建一个循环,至少执行一次后续命令。使用 repeat if 命令终止分支。
double click at
:元素定位器。
double click at
双击目标元素(例如链接、按钮、复选框或单选按钮)。坐标相对于目标元素(例如,0,0 是元素的左上角),主要用于检查依赖于这些坐标的效果,例如 material ripple 效果。
参数
drag and drop to object
拖动一个元素并将其放到另一个元素上。
参数
要拖动的对象的定位器:要拖动的元素的定位器。
拖放目标对象的定位器:元素的定位器,其位置(例如,其中的最中心像素)将是 locator of object to be dragged 放置的位置。
echo
将指定的消息打印到 Selenese 表格中的第三个表格单元格中。对调试很有用。
参数
- message:要打印的消息。
编辑内容
设置内容可编辑元素的值,就像你输入内容一样。
参数
else
if 块的一部分。当 if 和/或 else if 条件不满足时,执行此分支中的命令。使用 end 命令终止分支。
else if
if 块的一部分。当 if 条件未满足时,执行此分支中的命令。使用 end 命令终止分支。
参数
- 条件表达式:JavaScript 表达式,用于在控制流命令中返回布尔结果。
end
终止 if、while 和 times 的控制流块。
execute script
在当前选定的框架或窗口的上下文中执行 JavaScript 片段。脚本片段将作为匿名函数的主体执行。若要存储返回值,请使用“return”关键字并在值输入字段中提供变量名。
参数
execute async script
在当前选定的框架或窗口的上下文中执行 JavaScript 的异步片段。脚本片段将作为匿名函数的主体执行,并且必须返回 Promise。如果您使用“return”关键字,Promise 结果将保存在变量中。
参数
for each
创建一个循环,为给定集合中的每个项目执行后续命令。
参数
array variable name:包含 JavaScript 数组的变量的名称。
迭代变量名称:在循环控制流命令(例如 for each)中迭代集合时使用的变量名称。
if
在测试中创建条件分支。使用 end 命令终止分支。
参数
- 条件表达式:JavaScript 表达式,用于在控制流命令中返回布尔结果。
mouse down
模拟用户按下鼠标左键(但尚未释放)。
参数
- 定位器:元素定位器。
mouse down at
模拟用户在指定位置按下鼠标左键(但尚未释放)。
参数
mouse move at
模拟用户在指定元素上按下鼠标按钮(但尚未释放)。
参数
鼠标悬停
:元素定位器。
鼠标悬停
模拟用户将鼠标悬停在指定元素上。
参数
- 定位器:元素定位器。
鼠标弹起
模拟用户释放鼠标按钮(例如,停止按住按钮)时发生的事件。
参数
- 定位器:元素定位器。
鼠标弹起于
模拟用户在指定位置释放鼠标按钮(例如,停止按住按钮)时发生的事件。
参数
打开
打开一个 URL,并等待页面加载后再继续。这接受相对 URL 和绝对 URL。
参数
- url:要打开的 URL(可以是相对 URL 或绝对 URL)。
pause
等待指定的时间。
参数
- 等待时间: 等待的时间(以毫秒为单位)。
remove selection
使用选项定位器从多选元素中删除选定选项集中的一个选项。
参数
repeat if
有条件地终止“do”控制流分支。如果提供的条件表达式的结果为真,则重新开始 do 循环。否则,结束循环。
参数
- 条件表达式:JavaScript 表达式,用于在控制流命令中返回布尔结果。
run
从当前项目运行测试用例。
参数
- 测试用例: 项目中的测试用例名称。
run script
在当前测试窗口的主体中创建一个新的“脚本”标签,并将指定文本添加到命令的主体中。请注意,这些脚本标签中引发的 JS 异常不会由 Selenium 管理,因此,如果脚本有可能引发异常,则你可能需要将脚本包装在 try/catch 块中。
参数
- script:要运行的 JavaScript 片段。
select
使用选项定位器从下拉菜单中选择元素。选项定位器提供了指定选择元素的不同方法(例如,label=、value=、id=、index=)。如果没有提供选项定位器前缀,则将尝试匹配标签。
参数
select locator:一个元素定位器,用于识别下拉菜单。
选项: 选项定位器,通常只是一个选项标签(例如,“John Smith”)。
select frame
在当前窗口中选择一个框架。你可以通过其基于 0 的索引号选择一个框架(例如,使用“index=0”选择第一个框架,或使用“index=2”选择第三个框架)。对于嵌套框架,你需要多次调用此命令(对树中的每个框架调用一次,直到到达所需的框架)。你可以使用“relative=parent”选择父框架。要返回页面的顶部,请使用“relative=top”。
参数
- 定位器:元素定位器。
select window
使用窗口定位器选择一个弹出窗口。一旦选择了一个弹出窗口,所有命令都将转到该窗口。窗口定位器使用句柄来选择窗口。
参数
- 窗口句柄:表示特定页面(标签或窗口)的句柄。
发送键值
模拟在指定元素上按键盘事件,就像你逐个键入值一样。这模拟了真实用户在指定字符串中键入每个字符;它也受真实用户的限制,比如不能键入不可见或只读元素。这对于需要显式按键事件的动态 UI 小部件(如自动完成组合框)很有用。与直接将指定值强制到页面的简单“type”命令不同,此命令不会替换现有内容。
参数
设置速度
设置执行速度(例如,设置每个 Selenium 操作后将遵循的延迟的毫秒长度)。默认情况下,没有这样的延迟,例如,延迟为 0 毫秒。此设置是全局的,并且会影响所有测试运行,直到更改为止。
参数
- 等待时间: 等待的时间(以毫秒为单位)。
设置窗口大小
设置浏览器的窗口大小,包括浏览器的界面。
参数
- resolution:使用 WidthxHeight 指定窗口分辨率。(例如,1280x800)。
store
将目标字符串另存为变量以便轻松重复使用。
参数
store attribute
获取元素属性的值。属性的值可能因浏览器而异(例如,“style”属性就是这种情况)。
参数
attribute locator:元素定位器后跟一个 @ 符号,然后是属性的名称,例如“foo@bar”。
变量名:没有括号的变量名。
store json
undefined
参数
store text
获取元素的文本并将其存储起来以供以后使用。这适用于包含文本的任何元素。
参数
store title
获取当前页面的标题。
参数
store value
获取元素的值并存储以供以后使用。这适用于任何输入类型元素。
参数
store window handle
获取当前页面的句柄。
参数
- 窗口句柄:表示特定页面(标签或窗口)的句柄。
store xpath count
获取与指定 xpath 匹配的节点数(例如,“//table”将给出表格数)。
参数
提交
提交指定的表单。这对于没有提交按钮的表单特别有用,例如单输入“搜索”表单。
参数
- 表单定位器:要提交的表单的元素定位器。
次数
创建一个循环,执行 n 次后续命令。
参数
类型
设置输入字段的值,就像您输入一样。还可以用于设置组合框、复选框等的值。在这些情况下,值应该是所选选项的值,而不是可见文本。仅限 Chrome:如果给定文件路径,它将上传到输入(对于 type=file),注意:不支持 XPath 定位器。
参数
uncheck
取消选中切换按钮(复选框/单选按钮)。
参数
- 定位器:元素定位器。
verify
软断言变量为预期值。变量的值将转换为字符串进行比较。即使验证失败,测试也将继续。
参数
verify checked
软断言切换按钮(复选框/单选按钮)已被选中。即使验证失败,测试也将继续。
参数
- 定位器:元素定位器。
verify editable
软断言指定的输入元素是否可编辑(例如,尚未禁用)。即使验证失败,测试也将继续。
参数
- 定位器:元素定位器。
verify element present
软断言指定的元素位于页面上的某个位置。即使验证失败,测试也将继续。
参数
- 定位器:元素定位器。
verify element not present
软断言指定的元素不在页面上的某个位置。即使验证失败,测试也将继续。
参数
- 定位器:元素定位器。
verify not checked
软断言切换按钮(复选框/单选按钮)尚未选中。即使验证失败,测试也将继续。
参数
- 定位器:元素定位器。
verify not editable
软断言指定的输入元素不可编辑(例如,尚未禁用)。即使验证失败,测试仍会继续。
参数
- 定位器:元素定位器。
verify not selected value
软断言预期元素未通过其选项属性在选择菜单中被选中。即使验证失败,测试仍会继续。
参数
select locator:一个元素定位器,用于识别下拉菜单。
选项: 选项定位器,通常只是一个选项标签(例如,“John Smith”)。
verify not text
软断言元素的文本不存在。即使验证失败,测试仍会继续。
参数
验证选定标签
对指定选择元素中选定选项的可见文本进行软断言。即使验证失败,测试仍将继续。
参数
select locator:一个元素定位器,用于识别下拉菜单。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
验证选定值
通过其选项属性对选择菜单中已选择的预期元素进行软断言。即使验证失败,测试仍将继续。
参数
select locator:一个元素定位器,用于识别下拉菜单。
选项: 选项定位器,通常只是一个选项标签(例如,“John Smith”)。
验证文本
对元素文本是否存在进行软断言。即使验证失败,测试仍将继续。
参数
验证标题
对当前页面的标题进行软断言,其中包含提供的文本。即使验证失败,测试仍将继续。
参数
- 文本:要使用的文本。
:元素定位器。
text:一个精确的字符串匹配。对模式匹配的支持正在进行中。有关详细信息,请参阅 https://github.com/SeleniumHQ/selenium-ide/issues/141。
等待元素可编辑
等待元素可编辑。
参数
等待元素不可编辑
等待元素不可编辑。
参数
等待元素不存在
等待目标元素不在页面上。
参数
等待元素不可见
等待目标元素在页面上不可见。
参数
等待元素出现
等待目标元素在页面上出现。
参数
等待元素可见
等待目标元素在页面上可见。
参数
webdriver 回答可见提示
影响当前显示的警报提示。此命令指示 Selenium 向其提供指定的答案。如果警报尚未出现,请改用“回答下一个提示”。
参数
- 答案:对提示弹出窗口的响应答案。
webdriver 选择取消可见确认
影响当前显示的确认警报。此命令指示 Selenium 取消它。如果警报尚未出现,请改用“选择取消下一个确认”。
webdriver choose cancel on visible prompt
影响当前显示的警报提示。此命令指示 Selenium 取消它。如果警报尚未出现,请改用“选择取消下一个提示”。
webdriver choose ok on visible confirmation
影响当前显示的确认警报。此命令指示 Selenium 接受它。如果警报尚未出现,请改用“选择确定下一个确认”。
while
创建一个循环,只要提供的条件表达式为真,就重复执行后续命令。
参数