脚本引擎 API

流程控制 API

runtime.process.* 日志输出与脚本流程控制。支持信息/警告/错误日志、终止和暂停。

当前:流程控制 API
脚本引擎 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("等待超时");
}