冰狐智能辅助 QQ群：693133887
首页
文档&下载
移动端
微服务
社区
码农教程
管理中心
关于我们
登录/注册
js

自动化脚本和微服务都使用js语言，是我们自己实现的一个标准ECMAScript(JavaScript)的子集，比标准JavaScript简单很多，没有编程基础的同学也能很快掌握；支持标准JavaScript函数库；支持多线程并发编程，在线编辑、动态部署并立即生效。

1.例子（可直接运行）

启动微信并滚动微信页面（点击展开） 
function main() {
    // 启动微信
    var ret = launchApp('com.tencent.mm', 'txt*:微信', {maxStep: 40, afterWait: 2000});
    if (1 == ret) {
        console.log('进入微信成功');
        var index = 0;
        /* 滚动三次微信 */
        while (index < 3) {
            scroll('up', {distance: Math.random() * 0.5 + 0.45, duration: parseInt(Math.random() * 200 + 300), afterWait: 2000});
            ++index;
            console.log('滚动:' + index);
        }
        console.log('任务结束，退出');
    } else {
        console.log('启动微信失败');
    }
}

2.数据类型及常量

类型名 说明
number 包括整型，和浮点型，例：整型常量 12，浮点型 3.4。
boolean 支持常量true，false，分别表示真和假，用于if语句的条件表达式。
string 字符串常量用''或""表示，例：'hello'。支持模版字符串，用``(两个反引号)表示，可以嵌入变量，例:`hello ${name}`，在执行过程中会动态解析字符串值。
array json数组类型，用[]创建json数组，可以用[]操作符访问数组，第一个元素从0开始，依此类推。注意：数组支持负索引，比如arr[-1]表示取arr的最后一个元素，-2表示倒数第二个元素，依次类推。例：var arr =['z', 12];var a=arr[-1];var b = arr[0];。
object json对象类型，其本质是键值对，用{}创建json对象，可以用.和[]操作符访问属性。例:var obj = {name:'a', value:12};var a = obj.name; var b = obj['name'];。

3.运算符

运算符用于赋值、比较值、执行算术运算等。
类型 运算符
算数运算符 +、-、*、/、%、++、--
比较运算符 >、>=、<、<=、!=、==（注意这里取消了繁杂的===和!==）
逻辑运算符 &&、||、！
赋值运算符 =、+=、-=、*=、/=、%=
字符串运算符 +、+=
三元运算符 ?:
其他运算符 typeof、delete、new
下表从最高到最低的优先级列出js运算符，具有相同优先级的运算符按从左至右的顺序求值。
运算符 说明
()、[]、. 函数调用以及表达式分组、数组访问、对象字段访问
++、--、!、delete、new、typeof 一元运算符，只有一个操作数
*、/、% 二元运算符，乘法、除法、取模
+、- 二元运算符，加法、减法
==、!= 二元运算符，等于、不等于
&& 二元运算符，逻辑与
|| 二元运算符，逻辑或
?: 三元运算符，条件
=、+=、*=... 二元运算符，赋值、运算赋值

4.语句

语句 说明
var 声明变量，变量必须先声明才能使用。例：var a = 1, b, c = 'demo';
表达式 表达式用于实现基本的计算。例：b = 1 + a * 5;
if(条件)、 else if(条件)、 else 根据条件执行语句块。例：if (a == 'str') {...} else if (a == 'hello') {...} else {...}
switch(条件) 根据条件选择一个语句块执行。例：switch (a) {case 1:break;}
for...of遍历 遍历可迭代对象,支持数组、对象、字符串等。例：for(var item of container){...}
for循环 循环。例：for(var i = 0; i < 10; ++i){...}
while(条件){} 条件为true时执行语句块。例：while(a < 10){...}
do{...}while(条件) 先执行语句块，再判断条件，若为true则继续执行语句块。例：do{...}while(a < 10)
function 函数声明，支持默认参数。例：function main(a = 1, b = 'hello'){...}
break 退出循环，用于逻辑控制。
continue 中断一次循环，并继续循环中的下一次迭代，用于逻辑控制。
return 停止执行函数并从该函数返回值，用于逻辑控制。
import 导入其他脚本，import支持三种方式 1.线上的脚本，2.本地js文件，3.apk资源中的js（asset:前缀在打包apk时添加的js文件)，比如：import 'asset:temp.js'；直接使用手机本地js文件。例：import 'Xiaomi_runtime'; import '/sdcard/sample.js'; import 'asset:test.js';

5.脚本特性

变量必须先声明才能使用。例：var a = 10;。
支持//和/**/注释。
if、for、while、do-while等，即使仅有一条子语句也必须使用{}。
不支持匿名函数和闭包，但支持自定义函数赋值给变量或作为函数参数传递。
暂不支持位运算。
不支持===、!==，直接统一使用==、!=，简化使用。
支持函数默认参数。
支持import语句，导入脚本。注意：可以使用user.scriptName来访问一个团队内部其他成员的脚本。
支持模版字符串。
新增编译指令:__global、__permanent、__day（仅用于移动端脚本），用于 var后，分别表示声明全局变量，持久变量和day变量，全局变量可以在多个模块间共享，可以在不同线程间通信，例:var __global text；持久变量永久存在，在当前脚本文件可见，除非卸载程序；day变量作用域为一天，在当前脚本文件可见，每天0点day变量复位为初始值。
默认main函数为入口函数，外部可以传递参数给main函数，main返回值为脚本的返回值，可以使用callScript函数可以调用其他脚本。
支持系统事件回调，cbNotification(textList, className, packageName, rawEvent)、cbWindowChange(textList, className, packageName, rawEvent)、cbMessage(msgId, param1...)、cbForceExit(),开发者可以在脚本中定义这三个函数，当系统收到通知消息或窗口改变事件后，会自动调用回调函数。注意事件回调函数和main函数不在一个线程中执行，可以通过__global变量来进行通信。

6.系统事件和回调函数

系统事件和回调函数不需要开发者主动调用，系统会在适当时间自动调用。

cbNotification

当系统收到通知消息（比如微信消息、短消息等）时会自动该函数
参数：
参数名 类型 说明
textList array 通知中的文本数组
className string 类名
packageName string 包名
rawEvent Event 原始事件对象 
// 例子：
function main() {
}

function cbNotification(textList, className, packageName, rawEvent) {
    console.log('textList:' + textList + ' className:' + className + ' packageName:' + packageName);
}

cbWindowChange

窗口切换（比如app从一个页面切换到另外一个页面）后系统会自动该函数
参数：
参数名 类型 说明
textList array 窗口中文本
className string 类名
packageName string 包名
rawEvent Event 原始事件对象 
// 例子：
function main() {
}

function cbWindowChange(textList, className, packageName, rawEvent) {
    console.log('textList:' + textList + ' className:' + className + ' packageName:' + packageName);
}

cbMessage

在脚本中调用sendMessage函数后，系统会自动调用cbMessage回调函数。
参数：
参数名 类型 必填 说明
msgId string 必填 消息的唯一标识,系统内置消息id「run_msg」，用于显示程序内部运行的信息。
params... 可变参数 选填 任意个参数 
// 例子：
function main() {
}

function cbMessage(msgId， params) {
    console.log('msgId:' + msgId + ' params:' + params);
}

cbForceExit

脚本被强制停止后系统会自动调用cbForceExit回调函数。
参数：
参数名 类型 必填 说明 
// 例子：
function main() {
}

function cbForceExit(msgId， params) {
    console.log('force exit');
}

7.系统内置常量

系统内置常量以rs开头，可以直接在脚本中使用。
常量名 类型 说明
rsCurPackageName string 当前app的包名（仅用于移动端端脚本）
rsCurWindowClassName string 当前的窗口的类名（仅用于移动端端脚本）
rsScreenWidth integer 分辨率，屏幕宽，单位像素（仅用于移动端端脚本）
rsScreenHeight integer 分辨率，屏幕高，单位像素（仅用于移动端端脚本）
rsDensity float 屏幕密度 dp和px转换公式：px=dp*rsDensity（仅用于移动端端脚本）
rsUsername string 登录当前设备的用户名（仅用于移动端端脚本）
rsPhoneNumber string 当前设备的电话号码（仅用于移动端端脚本）
rsWX string 当前设备的微信名（仅用于移动端端脚本，仅供联系用）
rsDeviceName string 当前设备名（仅用于移动端端脚本）
rsUUID string 当前设备的uuid（仅用于移动端端脚本）
rsOpenId string 当前用户的openId（仅用于后端脚本）
rsIsDev boolean 当前是否处于调试状态（仅用于后端脚本）