在自动化脚本中实现定时执行脚本

在移动端自动化脚本开发过程中，延时等待、循环轮询、定点定时执行是非常高频的需求。例如等待 APP 页面加载完成后执行点击、每隔一段时间刷新页面状态、每日固定时间自动完成签到、定时采集数据等场景，都离不开定时调度能力。冰狐智能辅助平台针对移动端脚本运行环境，封装了三套独立的定时 API，分别适配单次延迟、固定间隔循环、复杂 Cron 定点调度三类业务场景，同时配套对应的销毁接口用于资源回收。和浏览器原生 JavaScript 定时器存在明显差异，自动化脚本引擎对定时函数存在专属语法约束，很多新手开发者容易因匿名函数、未清理定时器、变量作用域错误等问题出现脚本运行异常。本文完整梳理三类定时接口的参数定义、代码示例、适用场景、销毁逻辑与开发避坑规范，帮助开发者规范、稳定地在自动化脚本中实现各类定时需求。

一、冰狐定时 API 整体分类与核心差异

冰狐智能辅助提供三组成对的定时与销毁函数，覆盖全部定时场景，三者底层调度逻辑、生命周期、时间粒度完全不同，开发时需根据业务精准选型，核心区别如下：

1. setTimeout / clearTimeout：单次延迟定时器，指定毫秒后仅执行一次回调，执行完成自动失效，适用于短期延时操作；
2. setInterval / clearInterval：周期循环定时器，按固定毫秒间隔无限重复执行，无手动销毁则持续后台运行，多用于短周期轮询监控；
3. setCronTask / clearCronTask：Cron 表达式调度器，支持精确到分、时、日、月、周的长期定点任务，适合每日、每周、每月固定时刻执行的自动化流程。

平台统一硬性规范：三类定时器的回调参数仅支持全局具名函数，不支持匿名函数、箭头函数，直接传入函数名即可，行内匿名回调会直接触发脚本编译报错，这是移动端脚本引擎的安全限制，所有示例均遵循该规范编写。

另外官方文档重点提示：脚本编辑页面右上角 “调试执行” 按钮无法正常运行定时器逻辑，所有定时相关脚本必须在移动端冰狐 APP 内点击 “执行” 按钮才能完整触发定时调度，调试日志可通过网页端日志面板查看console.log输出内容。

二、单次延迟定时器 setTimeout 详细使用教程

1. 接口参数说明

setTimeout 用于实现延迟一段时间后执行一次操作，调用后返回定时器唯一 ID，可提前调用 clearTimeout 终止未执行的任务。

clearTimeout 仅接收定时器 ID 作为唯一入参，用于任务未触发前取消本次定时操作，若定时器已执行完毕，调用销毁函数无任何副作用，不会报错。

2. 基础代码示例

仅延迟 3 秒执行单次打印逻辑：

function main() {
    // 创建3000毫秒单次定时器，接收返回的定时器ID
    var timeHandler = setTimeout(delayCallback, 3000);
}
// 全局具名回调函数
function delayCallback() {
    console.log("3秒延迟任务执行完成");
}

3. 提前取消定时任务示例

部分场景下需要满足条件后终止延迟任务，例如页面提前加载完成，无需等待 3 秒延时：

function main() {
    var timeHandler = setTimeout(delayCallback, 3000);
    // 模拟业务判断，满足条件直接取消定时
    var pageReady = true;
    if(pageReady){
        clearTimeout(timeHandler);
        console.log("提前终止延迟任务");
    }
}
function delayCallback() {
    console.log("3秒延迟任务执行完成");
}

4. 典型适用场景

1. APP 启动、页面跳转后延时等待控件渲染完成，再执行点击、输入操作；
2. 弹窗、广告弹窗倒计时关闭后，再执行后续自动化流程；
3. 单次延迟提醒、延时截图、延迟数据导出等一次性操作。

三、周期循环定时器 setInterval 完整使用方法

setInterval 会按照设定的毫秒间隔持续循环执行回调函数，直到主动调用 clearInterval 销毁定时器 ID，适合需要持续监控页面状态的场景，若不手动销毁，定时器会常驻后台，造成设备耗电、内存占用升高。

1. 接口参数说明

参数结构与 setTimeout 完全一致，cb 为全局具名函数，time 为循环间隔毫秒数；clearInterval 接收定时器 ID 销毁循环任务。

2. 基础循环示例

每 3 秒打印日志，无停止条件会无限循环：

function main() {
    var loopHandler = setInterval(loopCallback, 3000);
}
function loopCallback() {
    console.log("循环任务，每3秒执行一次");
}

3. 带停止条件的规范写法

实际业务中循环任务必须设置终止条件，需将定时器 ID 存储为全局变量，回调内判断业务状态，达标后销毁定时器。多线程场景下，变量需添加__global修饰符保证跨线程可访问：

// 全局存储定时器ID，多线程兼容
var __global loopHandler = null;
function main() {
    loopHandler = setInterval(loopCallback, 3000);
}
function loopCallback() {
    console.log("监控页面状态中");
    // 模拟业务终止条件：检测到目标控件则停止循环
    var targetView = findView("txt:任务完成");
    if(targetView != null && loopHandler != null){
        clearInterval(loopHandler);
        loopHandler = null;
        console.log("检测到任务完成，终止循环定时器");
    }
}

4. 适用场景与性能提醒

适用场景：商品库存轮询、消息列表持续刷新、任务进度实时监控、定时滑动页面等短周期重复操作。性能注意：循环间隔不宜设置过短（低于 1000 毫秒），回调内部避免 OCR 识别、多页面遍历等重度逻辑，否则会造成手机 CPU 持续高负载，出现卡顿、脚本闪退问题；长期循环任务优先改用 Cron 调度。

四、Cron 定点调度 setCronTask 高级定时方案

针对每日打卡、固定时段数据采集、每周定时任务等长期、精准时间点执行的需求，平台提供基于 cron4j 标准的 Cron 调度 API，支持复杂时间规则配置，是长期自动化任务的最优选择，时间粒度可精确到分钟，无需脚本持续驻留循环。

1. 接口完整参数说明

setCronTask 相比前两类定时器增加三个可选控制参数，灵活处理任务冲突、脚本启停逻辑：

clearCronTask 仅接收 Cron 调度 ID 作为参数，用于永久注销定时调度规则。

2. 最简示例：每分钟执行一次任务

function main() {
    console.log("启动Cron定时调度");
    // cron表达式* * * * * 代表每分钟执行一次，三个可选参数均使用默认false
    var cronTaskId = setCronTask(cronCallback, "* * * * *", false, false, false);
}
function cronCallback() {
    console.log("每分钟自动执行定时业务");
}

3. 带自动注销逻辑的完整示例

全局存储调度 ID，任务执行一次后注销调度，避免持续触发：

var __global cronTaskId = null;
function main() {
    cronTaskId = setCronTask(cronCallback, "* * * * *", false, false, false);
}
function cronCallback() {
    console.log("执行定点定时任务");
    if(cronTaskId != null){
        clearCronTask(cronTaskId);
        cronTaskId = null;
        console.log("注销Cron定时调度");
    }
}

4. 常用 Cron 表达式参考

1. 0 30 8 * * ?：每日早上 8 点 30 分执行，适合 APP 自动打卡；
2. 0 0 12 * * ?：每天中午 12 点执行；
3. 0 0 9 ? * MON：每周一上午 9 点执行；
4. 0 0 20 1 * ?：每月 1 号晚上 20 点执行。

5. 适用场景

企业级多账号批量签到、每日定时数据采集、固定时段自动清理缓存、每周报表导出、月度定时任务等长周期、精准时间点自动化需求。多设备集群场景下，还可搭配冰狐微服务 + 云端 Cron 调度，远程批量触发所有手机设备执行脚本，实现统一管控。

五、定时脚本开发通用规范与避坑指南

结合官方文档与实际开发踩坑经验，整理稳定运行定时脚本的核心规范，规避报错、内存泄漏、任务失效等问题：

1. 严格禁止匿名回调函数冰狐引擎不支持setTimeout(function(){},1000)、箭头函数等写法，所有定时回调必须在全局提前定义独立 function，仅传入函数名，否则脚本直接编译失败。
2. 定时器 ID 统一全局存储，多线程添加__global 修饰setInterval、setCronTask 的销毁操作往往在回调函数内部执行，普通局部变量无法跨函数访问，必须将定时器 ID 声明为全局变量；多线程并发运行脚本时，添加__global关键字修饰，保证多线程可读取 ID。
3. 闲置定时器必须主动销毁setInterval、setCronTask 创建后会持续占用系统调度资源，业务流程完成、脚本退出前，务必调用对应 clear 接口销毁 ID，防止后台残留大量定时任务，引发手机耗电、脚本卡死、内存溢出。即使定时器已执行完成，销毁操作也不会产生异常，建议养成 “创建即销毁” 的编码习惯。
4. 区分调试与正式运行入口网页编辑器内的调试按钮无法触发定时器调度逻辑，仅能用于基础语法校验；完整测试定时功能必须将脚本发布至移动端，在冰狐 APP 内点击执行按钮运行，通过网页日志面板查看定时回调输出。
5. 合理选型，避免资源浪费短期页面延时用 setTimeout；短周期状态监控用 setInterval 并设置终止条件；每日、每周长期定点任务优先 setCronTask，不要用高频循环替代 Cron 调度，降低设备负载。
6. 耗时逻辑拆分，防止任务阻塞若回调内部包含截图、OCR、多 APP 切换、批量点击等耗时操作，会拉长实际执行时间，导致 setInterval 出现任务堆积；重度业务建议拆分逻辑，或改用 Cron 拉大执行间隔。

六、综合实战案例：自动签到完整定时脚本

结合三种定时 API，模拟日常 APP 自动签到全流程，融合延时等待、循环监控、每日定点调度逻辑，直观展示多定时器协同使用方式：

// 全局存储循环定时器、Cron调度ID
var __global loopHandler = null;
var __global cronTaskId = null;

function main() {
    // 1. 注册每日8点30分自动签到Cron任务
    cronTaskId = setCronTask(signTask, "0 30 8 * * ?", false, false, false);
    console.log("已注册每日8:30签到定时任务");
}

// Cron定点签到主逻辑
function signTask() {
    console.log("开始执行每日签到流程");
    launchApp("目标打卡APP");
    // 延迟2秒等待APP启动渲染
    setTimeout(waitPageLoad, 2000);
}

// 延时回调：页面加载完成后开启循环监控签到按钮
function waitPageLoad() {
    console.log("APP页面加载完成，开始监控签到按钮");
    loopHandler = setInterval(checkSignBtn, 1500);
}

// 循环监控签到按钮，找到后点击并销毁定时器
function checkSignBtn() {
    var signBtn = findView("txt:立即签到");
    if(signBtn != null){
        click(signBtn);
        console.log("签到操作完成");
        // 销毁循环定时器
        if(loopHandler != null){
            clearInterval(loopHandler);
            loopHandler = null;
        }
    }
}

该脚本实现每日 8 点 30 分自动启动打卡 APP，延时等待页面加载后循环检测签到按钮，点击完成后自动终止循环，全程无需人工干预，覆盖定时开发主流 API 用法，符合平台开发规范。

结语

定时调度是冰狐智能辅助自动化脚本的核心能力之一，三套定时 API 分层覆盖从毫秒级短期延时到日月级长期定点任务的全部需求。开发过程中，核心要把握 “区分场景选型、规范回调函数、及时销毁定时器、适配移动端运行入口” 四大关键点，规避平台专属语法限制带来的报错问题。在实际项目开发中，简单自动化流程可仅使用 setTimeout 与 setInterval 完成；长期稳定运行的批量设备、每日固定任务场景，优先选择 setCronTask 实现精准调度，搭配全局变量管理定时器资源，能够大幅提升自动化脚本的稳定性，减少设备性能损耗与异常闪退问题，充分发挥移动端无人值守自动化的价值。