键盘与等待节点
键盘节点用于向当前页面发送按键，等待节点用于让流程在满足时间、页面、元素或网络条件后继续执行。本页包含 2 个键盘操作节点和 4 个等待操作节点。
键盘操作
键盘按键
从预设键位中选择一个按键并发送到当前页面。
| 编号 | 配置 | 说明 |
|---|---|---|
| 1 | 键盘按键 | 从预设列表中选择要发送的按键 |
发送按键前，确认正确的页面元素已经获得焦点。需要时先使用元素聚焦或点击元素节点。常见用法包括在输入框中发送 Enter、使用 Tab 移动焦点、使用方向键操作控件，以及使用 Escape 关闭弹层。
组合键
用于录制并发送多个按键组成的快捷键。节点会校验组合键格式。
| 编号 | 配置 | 说明 |
|---|---|---|
| 1 | 组合键 | 点击输入区域并录制要发送的快捷键，必须符合当前系统支持的格式 |
组合键可能受到操作系统、浏览器和网页自身快捷键的影响。同一流程需要在不同平台运行时，应分别调试确认结果。避免把系统级高风险快捷键加入正式流程。
等待时间
让流程暂停指定毫秒数，支持固定等待和区间随机两种方式。
| 编号 | 配置 | 说明 |
|---|---|---|
| 1 | 等待方式 | 选择固定值或区间随机 |
| 2 | 等待时长 | 固定值模式填写单个毫秒数；区间随机模式改为填写最小值和最大值 |
固定等待默认值为 2000ms，区间随机默认范围为 1000-2000ms。最小值不应大于最大值。
等待网页内容时，优先使用 等待元素出现 或 等待请求完成，因为固定时长无法保证页面状态已经满足。
等待页面加载完成
等待当前活动标签页的 DOM 进入可操作状态。页面的 document.readyState 已经是 interactive 或 complete 时，节点会立即继续；否则持续检查，直到页面可操作或达到超时时间。
| 配置 | 说明 |
|---|---|
| 超时等待 | 最长等待时间，单位为毫秒，默认 30000ms |
| 备注 | 可选的节点说明，不参与执行逻辑 |
把该节点放在访问网站、点击跳转或切换标签页之后。前一个页面操作打开新标签页时，节点会接管该标签页并等待其加载完成，后续滚动、点击和关闭标签等页面节点会继续操作新页面。
超过配置时间页面仍不可操作时，节点会按超时失败处理，流程是否继续由异常处理配置决定。该节点不等待图片、iframe 或第三方资源全部结束；对于 DOM 就绪后继续异步渲染的 SPA 页面，应在其后添加 等待元素出现，等待具体业务元素可见。
等待元素出现
持续检查指定页面元素，直到满足期望状态或达到超时时间。
| 编号 | 配置 | 说明 |
|---|---|---|
| 1 | 元素来源 | 使用元素选择器，或切换为上游保存的元素对象 |
| 2 | 选择器类型 | 选择 Selector、XPath 或文本 |
| 3 | 选择器 | 填写要等待的元素定位值，支持变量 |
| 4 | 元素顺序 | 选择固定值或区间随机，并填写对应序号范围 |
| 5 | 是否可见 | 开启表示等待元素可见，关闭表示等待元素不可见 |
| 6 | 超时时间 | 设置等待超时，默认 30000ms |
| 7 | 结果保存至 | 可选填写变量名，保存本次等待结果 |
元素定位的完整规则见元素定位与选择器。保存结果到变量后，可以在后续 IF 条件中根据实际结果决定执行路径。
等待请求完成
根据请求 URL 等待网络请求结束。
| 编号 | 配置 | 说明 |
|---|---|---|
| 1 | 响应 URL | 填写能够识别目标请求的完整 URL，必须是合法地址 |
| 2 | 超时时间 | 设置等待请求超时，默认 10000ms |
使用步骤：先添加触发请求的点击、输入或页面操作，再添加等待请求完成，最后设置符合接口响应时间的超时。该节点只用于同步请求状态；如需提取请求内容或响应结果，使用监听请求触发或监听请求结果。
如何选择等待方式
页面是否可操作通常比“等待了多少秒”更重要。优先等待具体状态，可以减少网络速度变化造成的失败。
| 目标 | 推荐节点 |
|---|---|
| 明确暂停固定或随机时长 | 等待时间 |
| 等待页面跳转或新标签页的 DOM 可操作 | 等待页面加载完成 |
| 等待按钮、表格或弹窗出现 | 等待元素出现，期望可见 |
| 等待加载层或弹窗消失 | 等待元素出现，期望不可见 |
| 等待某个接口结束 | 等待请求完成 |
常见问题
键盘节点没有作用
检查当前标签页是否正确，以及目标元素是否已经获得焦点。可以在键盘节点前添加元素聚焦或点击元素，并观察调试日志中的执行顺序。
等待元素一直超时
检查选择器、期望状态和当前页面。元素位于延迟加载区域时，可能需要先滚动页面；页面刚跳转时，也要确认流程没有仍停留在旧标签页。
页面加载完成后，后续元素仍不可用
部分页面会在 DOM 就绪后继续加载接口数据或渲染组件，等待页面加载完成不会等待这些异步内容。如需等待它们，应继续使用等待元素出现或等待请求完成。
等待请求完成提示 URL 错误
静态值需要填写完整合法的请求 URL。如果 URL 来自变量，确认上游节点已经产生该变量，并在运行时能解析出正确地址。
固定等待在部分环境中仍然失败
不同环境的网络和页面响应时间可能不同。把固定等待改为元素或请求条件等待，并为条件等待设置合理超时。