Selenium IDE 使用指南七（参数定义）

系列文章导航

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

本文档整理了 Selenium IDE 命令中常用的参数定义。在使用各类指令（Command）时，正确理解这些参数的含义与格式对于编写稳定的自动化脚本至关重要。

参数详解

alertText

  • 描述：要检查的警告框（Alert）中的文字内容。

answer

  • 描述：响应弹出提示框（Prompt）时提供的答案。

attributeLocator

  • 描述：元素定位符，后跟 @ 符号及属性名称。
  • 示例：foo@bar

arrayVariableName

  • 描述：包含 JavaScript 数组的变量名称。

conditionalExpression

  • 描述：返回布尔结果（Boolean）的 JavaScript 表达式，用于控制流命令。

coord

  • 参数名：coord string
  • 描述：指定鼠标事件相对于定位器所找到元素的 x, y 坐标位置。
  • 示例：-10,20

expectedValue

  • 描述：您期望变量包含的结果（例如 true、false 或其他特定值）。

expression

  • 描述：您要存储的值或表达式。

formLocator

  • 参数名：form Locator
  • 描述：要提交的表单的元素定位器。

handle

  • 参数名：window handle
  • 描述：代表特定页面（选项卡或窗口）的句柄。

iteratorVariableName

  • 参数名：迭代器变量名称
  • 描述：在循环控制流命令中迭代集合时使用的变量名称（例如，用于 each 循环的变量）。

json

  • 描述：JavaScript 对象的字符串表示形式（JSON 字符串）。

keySequence

  • 参数名：按键序列
  • 描述：可以键入的键序列，用于发送键击。
  • 示例：${KEY_ENTER}

locator

  • 参数名：定位器
  • 描述：元素定位器（Element Locator）。

locatorOfDragDestinationObject

  • 参数名：拖动目标对象的定位器
  • 描述：目标元素的定位器，该元素的位置（例如中心像素）将成为被拖动对象放置的点。

locatorOfObjectToBeDragged

  • 参数名：要拖动的对象的定位器
  • 描述：要被拖动的元素的定位器。

loopLimit

  • 参数名：循环限制
  • 描述：可选参数，指定循环控制流命令可以执行的最大次数，用于防止无限循环。
  • 默认值：1000

message

  • 描述：要打印的消息内容。

optionLocator

  • 参数名：选项
  • 描述：一个选项定位器，通常只是一个选项标签。
  • 示例：John Smith

pattern

  • 参数名：text
  • 描述：完全匹配的字符串，支持模式匹配。
  • 参考：有关详细信息，请参见 GitHub Issue #141。

region

  • 参数名：区域
  • 描述：指定一个具有坐标和长度的矩形区域。
  • 示例：x:257,y:300,width:462,height:280

resolution

  • 参数名：分辨率
  • 描述：使用 宽 x 高 指定窗口分辨率。
  • 示例：1280x800

script

  • 描述：要运行的 JavaScript 代码段。

selectLocator

  • 参数名：选择定位器
  • 描述：标识下拉菜单（Select）的元素定位器。

testcase

  • 参数名：测试用例
  • 描述：项目中的测试用例名称。

text

  • 参数名：文本
  • 描述：要使用的文字内容。

times

  • 描述：控制流循环将执行其块内命令的次数。

url

  • 描述：要打开的 URL（可以是相对路径或绝对路径）。

value

  • 描述：要输入的值。

variableName

  • 参数名：变量名
  • 描述：不带括号的变量名称。

waitTime

  • 参数名：等待时间
  • 描述：等待时间，单位为毫秒（ms）。

xpath

  • 描述：要评估的 XPath 表达式。
说明：本文档基于 Selenium IDE 主流版本整理，部分参数行为可能随版本更新（如 Selenium IDE 3.x 至 4.x）而有所调整。在实际使用中，请以当前安装版本的官方文档或指令提示为准。