脚本引擎 API
流程控制 API
runtime.process.* 日志输出与脚本流程控制。支持信息/警告/错误日志、终止和暂停。
概述
日志输出和脚本流程控制。替代浏览器 API 中的 console.log / fetch / setTimeout 等标准功能。
方法列表
runtime.process.log(message): void— 输出信息日志(绿色)。runtime.process.warn(message): void— 输出警告日志(黄色)。runtime.process.error(message): void— 输出错误日志(红色)。runtime.process.stop(message?): void— 立即终止当前脚本的执行。脚本运行结果显示为「失败」。runtime.process.pause(): void— 暂停脚本流程。通常用于等待用户手动操作后继续。
局限性说明
JS 运行时基于 Rhino 引擎(纯 Java),与浏览器 JS 引擎有差异,以下常用 API 不可用:
- 无 console.log → 使用
runtime.process.log()/warn()/error()。 - 无 setTimeout/setInterval → 使用
runtime.touch.sleep(ms)。 - 无 fetch/XMLHttpRequest → 使用
runtime.network.getText()/postText()/request()。 - 无 document/window/navigator → DOM/BOM API 全部不可用。
- 支持:JSON.parse/stringify、Date、Array 方法、箭头函数、let/const、模板字符串。
调用示例
// 日志输出
runtime.process.log("开始执行任务");
runtime.process.warn("注意: 超时临近");
runtime.process.error("任务失败");
// 条件终止
if (runtime.vision.textExists("错误")) {
runtime.process.stop("检测到错误,终止脚本");
}// 暂停等待(用户在设备上手动操作后继续)
runtime.process.pause();
// 或使用 sleep + 等待代替
if (!runtime.vision.waitForText("继续", 10000)) {
runtime.process.stop("等待超时");
}