pressKey

abstract fun pressKey(xpath: String, keySequence: String)

模拟在指定元素上按下单个按键或组合键。 这对于提交表单、触发键盘快捷键或在复杂组件中导航非常有用。

使用方法:

  • 单个按键: "Enter", "ArrowDown", "a"

  • 组合键: 使用 + 连接修饰键和主键,例如 "Ctrl+C", "Shift+Tab", "Alt+F4"。 修饰键不区分大小写 (ctrl, shift, alt, meta)。

支持的按键示例:

  • 功能键: "Enter", "Tab", "Escape", "Backspace", "Delete"

  • 方向键: "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight"

  • 字母/数字: "a", "B", "5"

  • 更多特殊键请参考实现中的映射表。

Parameters

xpath

目标元素的XPath。

keySequence

要模拟的按键序列字符串。

Throws

如果根据XPath未找到任何元素。

如果传入了不支持的按键或格式不正确的序列。