系列导航

  1. Selenium IDE 使用指南一（爬虫脚本录制器）
  2. Selenium IDE 使用指南二（命令行运行器）
  3. Selenium IDE 使用指南三（控制流）
  4. Selenium IDE 使用指南四（代码导出）
  5. Selenium IDE 使用指南五（常见问题）
  6. Selenium IDE 使用指南六（指令列表）
  7. Selenium IDE 使用指南七（参数定义）

指令列表

以下是 Selenium IDE 常用指令的详细说明，包含指令功能描述及参数定义。

add selection

将选项添加到多选元素（Multi-select）的选定项集合中。

参数

answer on next prompt

用于处理下一个弹出的提示框（Prompt）。此命令将向提示框发送指定的答案字符串。如果提示框已存在，请改用 webdriver answer on visible prompt。

参数

  • 答案：提示框弹出时给出的答案。

assert

硬断言：检查变量是否为期望值。变量的值将转换为字符串进行比较。若断言失败，测试将立即停止。

参数

assert alert

硬断言：确认已使用提供的文本呈现警告框（Alert）。若断言失败，测试将立即停止。

参数

assert checked

硬断言：确认目标元素已被选中（Checked）。若断言失败，测试将立即停止。

参数

assert confirmation

硬断言：确认已提交确认框（Confirmation）。若断言失败，测试将立即停止。

参数

  • text：要使用的文本。

assert editable

硬断言：确认目标元素是可编辑的。若断言失败，测试将立即停止。

参数

assert element present

硬断言：确认目标元素存在于页面上的某处。若断言失败，测试将立即停止。

参数

assert element not present

硬断言：确认目标元素不在页面上任何地方。若断言失败，测试将立即停止。

参数

assert not checked

硬断言：确认目标元素未被选中。若断言失败，测试将立即停止。

参数

assert not editable

硬断言：确认目标元素不可编辑。若断言失败，测试将立即停止。

参数

assert not selected value

硬断言：确认下拉元素中所选选项的 value 属性不包含提供的值。若断言失败，测试将立即停止。

参数

assert not text

硬断言：确认元素的文本不包含提供的值。若断言失败，测试将立即停止。

参数

assert prompt

硬断言：确认已呈现 JavaScript 提示框。若断言失败，测试将立即停止。

参数

  • text：要使用的文本。

assert selected value

硬断言：确认下拉元素中所选选项的 value 属性包含提供的值。若断言失败，测试将立即停止。

参数

assert selected label

硬断言：确认下拉菜单中所选选项的标签（Label）包含提供的值。若断言失败，测试将立即停止。

参数

assert text

硬断言：确认元素的文本包含提供的值。若断言失败，测试将立即停止。

参数

assert title

硬断言：确认当前页面的标题包含提供的文本。若断言失败，测试将立即停止。

参数

assert value

硬断言：确认输入字段的值（或其他带有 value 属性的值）。对于复选框/单选元素，根据是否选中该元素，其值为 on 或 off。若断言失败，测试将立即停止。

参数

check

选中一个切换按钮（复选框/单选按钮）。

参数

choose cancel on next confirmation

影响下一个确认框（Confirmation）。此命令将取消它。如果确认框已经存在，请使用 webdriver choose cancel on visible confirmation。

choose cancel on next prompt

影响下一个提示框（Prompt）。此命令将取消它。如果提示框已经存在，请使用 webdriver choose cancel on visible prompt。

choose ok on next confirmation

影响下一个确认框（Confirmation）。此命令将接受它。如果确认框已经存在，请使用 webdriver choose ok on visible confirmation。

click

单击目标元素（例如链接、按钮、复选框或单选按钮）。

参数

click at

单击目标元素的特定坐标位置。坐标是相对于目标元素的（例如 0,0 是元素的左上角），主要用于检查在其上触发的事件效果（如 Material Ripple 效果）。

参数

  • locator：元素定位器。
  • 坐标字符串：指定鼠标事件相对于从定位器找到的元素的 x,y 位置（例如 10,20）。

close

关闭当前窗口。无需关闭初始窗口，IDE 会重新使用它；关闭它可能会导致测试性能下降。

debugger

中断执行并进入浏览器调试器。

do

创建一个至少执行一次命令的循环。使用 repeat if 命令终止分支。

double click

双击元素（例如链接、按钮、复选框或单选按钮）。

参数

double click at

双击目标元素的特定坐标位置。坐标是相对于目标元素的，主要用于检查在其上触发的事件效果。

参数

  • locator：元素定位器。
  • 坐标字符串：指定鼠标事件相对于从定位器找到的元素的 x,y 位置。

drag and drop to object

拖动一个元素并将其拖放到另一个元素上。

参数

echo

将指定的消息打印到日志中。对于调试很有用。

参数

edit content

设置内容可编辑元素（contenteditable）的值，就像您在其中键入一样。

参数

else

if 块的一部分。如果不满足 if 和/或 else if 条件，请在此分支中执行命令。使用 end 命令终止分支。

else if

if 块的一部分。如果不满足 if 条件，请在此分支中执行命令。使用 end 命令终止分支。

参数

  • 条件表达式：JavaScript 表达式，返回布尔值以用于控制流命令。

end

终止控制流块（if、while、times、do 等）。

execute script

在当前选定的框架或窗口的上下文中执行一段 JavaScript。脚本片段将作为匿名函数的主体执行。要存储返回值，请使用 return 关键字，并在值输入字段中提供一个变量名称。

参数

execute async script

在当前选定的框架或窗口的上下文中执行 JavaScript 的异步代码段。该脚本片段将作为匿名函数的主体执行，并且必须返回 Promise。如果您使用 return 关键字，则 Promise 结果将保存在变量中。

参数

for each

创建一个循环，为给定集合中的每个项目执行命令。

参数

if

在测试中创建一个条件分支。使用 end 命令终止分支。

参数

  • 条件表达式：JavaScript 表达式，返回布尔值以用于控制流命令。

mouse down

模拟用户按下鼠标左键（尚未释放）。

参数

mouse down at

模拟用户在指定位置按下鼠标左键（尚未释放）。

参数

  • locator：元素定位器。
  • 坐标字符串：指定鼠标事件相对于从定位器找到的元素的 x,y 位置。

mouse move at

模拟用户在指定元素上移动鼠标。

参数

  • locator：元素定位器。
  • 坐标字符串：指定鼠标事件相对于从定位器找到的元素的 x,y 位置。

mouse out

模拟用户将鼠标指针从指定元素移开。

参数

mouse over

模拟用户将鼠标悬停在指定元素上。

参数

mouse up

模拟当用户释放鼠标按钮时发生的事件。

参数

mouse up at

模拟当用户在指定位置释放鼠标按钮时发生的事件。

参数

  • locator：元素定位器。
  • 坐标字符串：指定鼠标事件相对于从定位器找到的元素的 x,y 位置。

open

打开 URL，然后等待页面加载，然后继续。这既接受相对 URL，也接受绝对 URL。

参数

  • url：要打开的 URL（可以是相对的或绝对的）。

pause

等待指定的时间。

参数

remove selection

使用选项定位器从多选元素中的一组选定选项中删除一个选择。

参数

  • locator：元素定位器。
  • option：一个选项定位器，通常只是一个选项标签（例如 John Smith）。

repeat if

有条件地终止 do 控制流分支。如果提供的条件表达式的结果为 true，则它将重新开始 do 循环。否则，它将结束循环。

参数

  • 条件表达式：JavaScript 表达式，返回布尔值以用于控制流命令。

run

从当前项目运行测试用例。

参数

run script

在当前测试窗口的主体中创建一个新的 script 标签，并将指定的文本添加到命令主体中。请注意，这些脚本标签中引发的 JS 异常不是由 Selenium 管理的，因此，如果脚本有可能引发异常，则应该将脚本包装在 try/catch 块中。

参数

  • script：要运行的 JavaScript 代码段。

select

使用选项定位器从下拉菜单中选择一个元素。选项定位符提供了指定选择元素的不同方法（例如 label=、value=、id=、index=）。如果未提供选项定位符前缀，则将尝试在标签上进行匹配。

参数

  • select locator：标识下拉菜单的元素定位器。
  • option：一个选项定位器，通常只是一个选项标签。

select frame

在当前窗口中选择一个框架（Frame）。您可以通过从 0 开始的索引号来选择帧（例如，选择 index=0 的第一帧或 index=2 的第三帧）。对于嵌套框架，您将需要多次调用此命令。您可以使用 relative=parent 选择父框架。要返回页面顶部，请使用 relative=top。

参数

select window

使用窗口定位器选择弹出窗口。选择弹出窗口后，所有命令都将转到该窗口。窗口定位器使用句柄（Handle）选择窗口。

参数

  • 窗口句柄：代表特定页面（选项卡或窗口）的句柄。

send keys

模拟指定元素上的击键事件，就像您按键键入值一样。这模拟真实用户在指定字符串中键入每个字符；它也受到实际用户的限制，例如不能键入不可见或只读元素。这对于需要显式键事件的动态 UI 小部件（如自动完成组合框）很有用。与简单的 type 命令直接将指定的值强制进入页面不同，该命令不会替换现有内容。

参数

  • locator：元素定位器。
  • 按键序列：可以键入的按键序列，可用于发送按键（例如 ${KEY_ENTER}）。

set speed

设置执行速度（例如，设置每次 Selenium 操作之后的延迟的毫秒长度）。默认情况下，不存在此类延迟（0 毫秒）。此设置是全局设置，将影响所有测试运行，直到更改。

参数

set window size

设置浏览器的窗口大小，包括浏览器的界面。

参数

  • resolution：使用 WidthxHeight 指定窗口分辨率（例如 1280x800）。

store

将目标字符串另存为变量，以方便重用。

参数

store attribute

获取元素属性的值。在不同的浏览器中，属性的值可能有所不同（例如 style 属性）。

参数

store json

未定义（保留指令）。

参数

store text

获取元素的文本并将其存储以备后用。这适用于任何包含文本的元素。

参数

store title

获取当前页面的标题。

参数

store value

获取元素的值并将其存储以供以后使用。这适用于任何输入类型元素。

参数

store window handle

获取当前页面的句柄。

参数

  • 窗口句柄：代表特定页面（选项卡或窗口）的句柄。

store xpath count

获取与指定 xpath 匹配的节点数（例如 //table 将给出表数）。

参数

submit

提交指定的表格。这对于没有提交按钮的表单特别有用，例如单输入“搜索”表单。

参数

times

创建一个循环执行 n 次执行命令。

参数

  • times：控制流循环将执行其块内命令的尝试次数。
  • 循环限制：一个可选参数，指定循环控制流命令可以执行的最大次数。这样可以防止无限循环。默认值设置为 1000。

type

设置输入字段的值，就像您在其中键入一样。也可以用于设置组合框、复选框等的值。在这种情况下，value 应该是所选选项的值，而不是可见的文本。

  • 仅限 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

软断言：确认所期望的元素尚未在其选择属性的选择菜单中选择。即使验证失败，测试也将继续。

参数

verify not text

软断言：确认元素的文本不存在。即使验证失败，测试也将继续。

参数

  • locator：元素定位器。
  • text：要使用的文本。

verify selected label

软断言：对指定的 select 元素中的选定选项进行验证。即使验证失败，测试也将继续。

参数

verify selected value

软断言：确认所期望的元素已通过其选项属性在选择菜单中选择。即使验证失败，测试也将继续。

参数

verify text

软断言：确认元素的文本存在。即使验证失败，测试也将继续。

参数

  • locator：元素定位器。
  • text：要使用的文本。

verify title

软断言：确认当前页面的标题包含提供的文本。即使验证失败，测试也将继续。

参数

  • text：要使用的文本。

verify value

软断言：确认输入字段的值。对于复选框/单选元素，根据是否选中该元素，其值为 on 或 off。即使验证失败，测试也将继续。

参数

wait for element editable

等待元素可编辑。

参数

wait for element not editable

等待元素不可编辑。

参数

wait for element not present

等待目标元素不出现在页面上。

参数

wait for element not visible

等待目标元素在页面上不可见。

参数

wait for element present

等待目标元素出现在页面上。

参数

wait for element visible

等待目标元素在页面上可见。

参数

webdriver answer on visible prompt

影响当前显示的警报提示。此命令指示 Selenium 为它提供指定的答案。如果尚未出现警报，请改用 answer on next prompt。

参数

  • 答案：提示弹出窗口时给出的答案。

webdriver choose cancel on visible confirmation

影响当前显示的确认警报。此命令指示 Selenium 取消它。如果警报尚未出现，请改用 choose cancel on next confirmation。

webdriver choose cancel on visible prompt

影响当前显示的警报提示。此命令指示 Selenium 取消它。如果警报尚未出现，请改用 choose cancel on next prompt。

webdriver choose ok on visible confirmation

影响当前显示的确认警报。此命令指示 Selenium 接受它。如果警报尚未出现，请改用 choose ok on next confirmation。

while

只要提供的条件表达式为 true，就创建一个循环重复执行命令。

参数

  • 条件表达式：JavaScript 表达式，它返回布尔值以用于控制流命令。
  • 循环限制：一个可选参数，指定循环控制流命令可以执行的最大次数。这样可以防止无限循环。默认值设置为 1000。
说明：本文档基于 Selenium IDE 3.x+ 版本（WebExtension/ standalone 版本）整理。部分指令行为可能因浏览器内核或 Selenium IDE 版本更新而略有差异，请以官方最新文档为准。