函数使用说明

## 功能介绍
数字机器人（SDR-skybird digital robot）内置函数引擎（函数引擎语言为ES6标准JavaScript），支持用户手动写表达式进行数据处理。

![](/media/202309/2023-09-11_112801_9458000.29617392599077896.png)

## 节点配置
![](/media/202309/2023-09-11_114428_0481800.4121305505411601.png)
### 配置表达式
内置系统变量、内存寄存器、持久寄存器、系统方法，还可以使用自定义函数
![](/media/202309/2023-09-11_114655_8443860.29005849300871467.png)
#### 系统变量$msg

![](/media/202309/2023-09-11_161621_4297980.31984033510968224.png)

$msg：是上一个节点输出结果的引用变量
#### 内存寄存器$db

![](/media/202309/2023-09-11_161540_9623190.30970737069790155.png)

- 内存寄存器：引擎内置的数据存储对象，可以理解为一个数组，数组内可以存储各种数据类型的值，目前支持：bool,int,string,float,map（Key-Value结构）,array。
- $db: 是内存寄存器的对象引用变量，通过$db对内存寄存器设置或获取不同类型的值。其封装了各种数据类型的get/set方法，通过下标索引参数（0…499）获取/设置。$db.isRisingEdge/$db.isFallingEdge用于判断上升/下降沿。上升/下降沿判断逻辑是通过上一个值和当前值变化判断，上升沿：false -> true，下降沿：true -> false。注意这里true和false不是严格意义上bool类型，JavaScript把null、undefined、0、NaN和空字符串''视为false，其他值一概视为true
例如：

```javascript
$db.setBoolValue(0,true);//表示设置下标0的数据为bool类型的值true；
$db.setBoolValue(0,false);//表示设置下标0的数据为bool类型的值false；
$db.isFallingEdge(0); //true

$db.setIntValue(1,0);//表示设置下标0的数据为int类型的值0；
$db.setIntValue(1,1);//表示设置下标0的数据为int类型的值1；
$db.isRisingEdge(1); //true
```
**PS: 内存寄存器顾名思义数据存储于内存，系统重启时内存寄存器中所有的数据都将丢失**

#### 持久寄存器$dbs

![](/media/202309/2023-09-11_161659_6704490.9807190252176402.png)
- 持久寄存器：引擎内置的数据存储对象，可以理解为一个map（Key-Value），和内存寄存器一样，可以支持存储bool,int,string,float,map（Key-Value结构）,array类型数据。数据都存放于SDR数据库
- $dbs: 是内存寄存器的对象引用变量，通过$dbs对持久寄存器设置或获取不同类型的值。其封装了各种数据类型的get/set方法，通过string类型Key获取设置值

- 总之，内存或持久寄存器给引擎提供了公共数据存储途径，借助寄存器在系统内跨引擎通讯。

#### 系统方法

![](/media/202309/2023-09-11_161755_8194410.7864153852195931.png)
SDR内置了丰富的系统方法，根据方法名称就能直观理解每个方法的含义，需要强调的是Lodash相关的方法并未完整列出，如果列表中没有找到Lodash相关方法，您也可以直接使用。[LodashJs文档](https://www.lodashjs.com/ "LodashJs文档")

#### 自定义方法
如果有些逻辑可以复用，我们建议您抽取出来封装成单独的方法。我们提供了自定义方法功能。

![](/media/202309/2023-09-11_154157_2981480.26523857168498854.png)

![](/media/202309/2023-09-11_154105_7015580.3767220005542967.png)

![](/media/202309/2023-09-11_154121_5493960.7374626265109584.png)

![](/media/202309/2023-09-11_154324_8629130.3614553007014384.png)

### 代码调试
业务逻辑写完后，可以使用代码调试功能调试代码。具体的操作如下：

1. 将debugger 作为单独一行插入到需要调试的代码前
![](/media/202309/2023-09-11_155338_0567160.6657320417231786.png)

2. 点击代码调试按钮，将弹出框中调试链接地址复制下来
![](/media/202309/2023-09-11_155935_4675970.9390472607916708.png)

3. 在浏览器新Tab中打开调试链接地址
![](/media/202309/2023-09-11_160255_5975500.4715952232485461.png)

4. 将函数节点保存，并触发执行
![](/media/202309/2023-09-11_160644_7162380.5065792504502711.png)

5. 回到第三步打开的新Tab，将看到调试断点已经打在debugger语句上，按照浏览器调试JS脚步的机制一步步往下调试即可
![](/media/202309/2023-09-11_160719_2039850.47673578136102346.png)