- [*Namespace* 解构(THINGX.Timer)](#namespace--解构thingxtimer)
- [*Method* THINGX.Timer.addInterval](#method--thingxtimeraddinterval)
- [*Method* THINGX.Timer.addTimeout](#method--thingxtimeraddtimeout)
- [*Method* THINGX.Timer.remove](#method--thingxtimerremove)
- [*Method* THINGX.Timer.removeAll](#method--thingxtimerremoveall)
- [*Method* THINGX.Timer.get](#method--thingxtimerget)
- [*Method* THINGX.Timer.getAll](#method--thingxtimergetall)
### *Namespace* 解构(THINGX.Timer)
> THINGX.Timer:namespace
```javascript
// 系统全局调度器为了统一管理 宏任务中的 定时器、延时器等函数
// 在系统插件或应该开发中,涉及定时器、延时器等函数宏任务时, 推荐统一使用该命名空间调度器进行管理使用
// 该系统调度器函数需要对ThingJS-X 系统使用的开发者重点了解的API
// 以帮助其在系统开发过程中进行规范开发,能够辅以错误定位、错误排查
//THINGX.Timer 解构
THINGX.Timer:namespace
Members
// - timers:Array. //proposal 提案
Methods
- addInterval(callback:function,delay:number,name:string[,params:any]):string
//添加重复执行定时器
- addTimeout(callback:function,delay:number,name:string[,params:any]):string
//添加一次性执行定时器
- remove(name:string):boolean
//移除特定定时器
- removeAll():void
//移除所有定时器
- get(id):Instance||null
//获取特定定时器
- getAll():Array.
//获取所有定时器
// - has(id:string):boolean
//检查定时器是否已存在 ,proposal 提案
Type Definitions
- Instance 实例
- callback:function 执行函数
- delay:number 延迟时间(毫秒/ms)
- id:string 唯一标识
- type:string 调度器类型[ interval、timeout ]
- params:Array 回调函数参数
```
### *Method* THINGX.Timer.addInterval
> 添加重复(或循环)执行定时器 THINGX.Timer.addInterval(callback:function,delay:number[,id:string,params:Array])
* 参数
||||||
|-|-|-|-|-|
|名称|类型|必填|默认值|描述|
|callback|function|是| - |定时器执行函数|
|delay|number|是|-| 定时器延时时间(毫秒/ms) |
|id|string|是|-| 唯一标识,默认自动生成匿名唯一标识 |
|params|Array|-|-| 回调函数参数 |
* 类型: string
* 示例
```javascript
//示例1. 每隔 15s 执行一次打印输出(给定唯一标识)
//return value interval unique identifier （返回指定的定时器唯一标识:forklift）
const timerid = THINGX.Timer.addInterval(()=>{
console.warn("use the layer plug-in to change the color of the forklift model.");
},1500,"forklift");
console.warn(" unique identifier : %s ", timerid);
//示例2. 每隔 15s 执行一次打印输出 (给定唯一标识和模型颜色)
//return value interval unique identifier （返回指定的定时器唯一标识:forklift-color）
const timerid = THINGX.Timer.addInterval((params)=>{
params?.forEach((element)=>{
console.warn("the forklift turned from yellow to %s.",element);
});
},1500,"forklift-color",['red','green']);
console.warn(" unique identifier : %s ", timerid);
```
***
### *Method* THINGX.Timer.addTimeout
> 添加一次执行定时器 THINGX.Timer.addTimeout(callback:function,delay:number[,id:string,params:Array])
* 参数
||||||
|-|-|-|-|-|
|名称|类型|必填|默认值|描述|
|callback|function|是| - |定时器执行函数|
|delay|number|是|-| 定时器延时时间(毫秒/ms) |
|id|string|是|-| 唯一标识,默认自动生成匿名唯一标识 |
|params|Array|-|-| 回调函数参数 |
* 类型: string
* 示例
```javascript
//示例1. 延时 10s 后执行一次打印输出(给定唯一标识)（仅执行一次）
//return value interval unique identifier （返回指定的定时器唯一标识:forklift）
const timerid = THINGX.Timer.addTimeout(()=>{
console.warn("use the layer plug-in to change the color of the forklift model.");
},1000,"forklift");
console.wran(" unique identifier : %s ", timerid);
//示例2. 延时 10s 后执行一次打印输出 (给定唯一标识和模型颜色)（仅执行一次）
//return value interval unique identifier （返回指定的定时器唯一标识:forklift-color）
const timerid = THINGX.Timer.addTimeout((params)=>{
params?.foreach((element)=>{
console.warn("the forklift turned from yellow to %s.",element);
});
},1000,"forklift-color",['red','green']);
console.wran(" unique identifier : %s ", timerid);
```
***
### *Method* THINGX.Timer.remove
> 移除特定(指定)定时器 THINGX.Timer.remove(id:string)
* 参数
||||||
|-|-|-|-|-|
|名称|类型|必填|默认值|描述|
|id|string|是| - |定时器唯一标识|
* 类型: boolean
* 示例
```javascript
//示例：移除特定(指定:forklift 叉车)定时器
const result = THINGX.Timer.remove("forklift");
console.warn("移除延时器 `forklift` : %s", result);
```
***
### *Method* THINGX.Timer.removeAll
> 移除Timer调度器内所有定时器 THINGX.Timer.removeAll()
* 示例
```javascript
//谨慎使用,执行后会将系统定时器等相关调度移除
//示例：移除Timer调度器内所有定时器
THINGX.Timer.removeAll();
```
***
### *Method* THINGX.Timer.get
> 获取特定定时器实例 THINGX.Timer.get(id):Instance||null
* 参数
||||||
|-|-|-|-|-|
|名称|类型|必填|默认值|描述|
|id|string|是| - |定时器唯一标识|
* 类型: Instance （Timer: Type Definitions）
* 示例
```javascript
//示例：获取特定(指定：forklift)定时器实例
const instance = THINGX.Timer.get("forklift");
console.warn("`forklift` 定时器实例 : ",instance);
//实例结构参考 系统调试器(THINGX.Timer) Type Definitions
```
***
### *Method* THINGX.Timer.getAll
> 获取Timer调度器内所有定时器 THINGX.Timer.getAll()
* 类型: Array. （Timer: Type Definitions）
* 示例
```javascript
//示例：获取Timer调度器内所有定时器
const instances = THINGX.Timer.getAll();
//打印输出获取到的 定时器实例
instances?.forEach((instance,index)=>{
console.warn("第 %s 个定时器实例: %s ", index, JSON.stringify(instance));
//实例结构参考 系统调试器(THINGX.Timer) Type Definitions
});
```
***
!> 系统全局调度器 支持
**质量保证:** `刘远健`
**审核校正:** `唐鑫` 、`张光光`
**问题反馈:** `张明雷(zhangminglei@uino.com)`