amis-formula 2.3.1 → 2.4.0

package/lib/doc.js

@@ -664,7 +664,7 @@ exports.doc = [
   },
   {
     name: "ESCAPE",
-    description: "对文本进行 HTML 转义\n\n示例 `ESCAPE(\"star\")`\n\n返回 `Star`",
+    description: "对文本进行 HTML 转义\n\n示例 `ESCAPE(\"<star>&\")`\n\n返回 `&lt;start&gt;&amp;`",
     example: "ESCAPE(text)",
     params: [
       {
@@ -1467,6 +1467,28 @@ exports.doc = [
     },
     namespace: "数组"
   },
+  {
+    name: "ARRAYFILTER",
+    description: "数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n将第二个箭头函数返回为 false 的成员过滤掉。",
+    example: "ARRAYFILTER(arr, item => item)",
+    params: [
+      {
+        type: "Array<any>",
+        name: "arr",
+        description: "数组"
+      },
+      {
+        type: "Array<any>",
+        name: "iterator",
+        description: "箭头函数"
+      }
+    ],
+    returns: {
+      type: "boolean",
+      description: "结果"
+    },
+    namespace: "数组"
+  },
   {
     name: "COMPACT",
     description: "数组过滤掉 false、null、0 和 \"\"\n\n示例：\n\nCOMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]",
@@ -1544,5 +1566,22 @@ exports.doc = [
       description: "结果"
     },
     namespace: "数组"
+  },
+  {
+    name: "ISTYPE",
+    description: "判断是否为类型支持：string, number, array, date, plain-object。",
+    example: "ISTYPE([{a: '1'}, {b: '2'}, {a: '1'}], 'array')",
+    params: [
+      {
+        type: "string",
+        name: "判断对象",
+        description: null
+      }
+    ],
+    returns: {
+      type: "boolean",
+      description: "结果结果"
+    },
+    namespace: "其他"
   }
 ]

package/lib/doc.md

@@ -412,9 +412,9 @@
 
 对文本进行 HTML 转义
 
-示例 `ESCAPE("star")`
+示例 `ESCAPE("<star>&")`
 
-返回 `Star`
+返回 `&lt;start&gt;&amp;`
 
 ### TRUNCATE
 
@@ -851,6 +851,18 @@ DATEMODIFY(A, -2, 'month')
 
 数组做数据转换，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
 
+### ARRAYFILTER
+
+用法：`ARRAYFILTER(arr, item => item)`
+
+ * `arr:Array<any>` 数组
+ * `iterator:Array<any>` 箭头函数
+
+返回：`boolean` 结果
+
+数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
+将第二个箭头函数返回为 false 的成员过滤掉。
+
 ### COMPACT
 
 用法：`COMPACT(arr)`
@@ -909,3 +921,15 @@ CONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']
 
 UNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')
 
+## 其他
+
+### ISTYPE
+
+用法：`ISTYPE([{a: '1'}, {b: '2'}, {a: '1'}], 'array')`
+
+ * `判断对象:string` null
+
+返回：`boolean` 结果结果
+
+判断是否为类型支持：string, number, array, date, plain-object。
+

package/lib/evalutor.d.ts

@@ -585,9 +585,9 @@ export declare class Evaluator {
     /**
      * 对文本进行 HTML 转义
      *
-     * 示例 `ESCAPE("star")`
+     * 示例 `ESCAPE("<star>&")`
      *
-     * 返回 `Star`
+     * 返回 `&lt;start&gt;&amp;`
      *
      * @example ESCAPE(text)
      * @param {string} text - 文本
@@ -1010,6 +1010,17 @@ export declare class Evaluator {
      * @returns {boolean} 结果
      */
     fnARRAYMAP(value: any, iterator: any): any[];
+    /**
+     * 数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
+     * 将第二个箭头函数返回为 false 的成员过滤掉。
+     *
+     * @param {Array<any>} arr 数组
+     * @param {Function<any>} iterator 箭头函数
+     * @namespace 数组
+     * @example ARRAYFILTER(arr, item => item)
+     * @returns {boolean} 结果
+     */
+    fnARRAYFILTER(value: any, iterator: any): any[];
     /**
      * 数组过滤掉 false、null、0 和 ""
      *
@@ -1065,6 +1076,15 @@ export declare class Evaluator {
      * @returns {Array<any>} 结果
      */
     fnUNIQ(arr: any[], field?: string): any[];
+    /**
+     * 判断是否为类型支持：string, number, array, date, plain-object。
+     *
+     * @param {string} 判断对象
+     * @namespace 其他
+     * @example ISTYPE([{a: '1'}, {b: '2'}, {a: '1'}], 'array')
+     * @returns {boolean} 结果结果
+     */
+    fnISTYPE(target: any, type: 'string' | 'number' | 'array' | 'date' | 'plain-object' | 'nil'): boolean;
 }
 export declare function createObject(superProps?: {
     [propName: string]: any;

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v2.3.1
+ * amis-formula v2.4.0
  * Copyright 2021-2022 fex
  */
 
@@ -17,6 +17,7 @@ var truncate = require('lodash/truncate');
 var uniqWith = require('lodash/uniqWith');
 var uniqBy = require('lodash/uniqBy');
 var isEqual = require('lodash/isEqual');
+var isPlainObject = require('lodash/isPlainObject');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -29,6 +30,7 @@ var truncate__default = /*#__PURE__*/_interopDefaultLegacy(truncate);
 var uniqWith__default = /*#__PURE__*/_interopDefaultLegacy(uniqWith);
 var uniqBy__default = /*#__PURE__*/_interopDefaultLegacy(uniqBy);
 var isEqual__default = /*#__PURE__*/_interopDefaultLegacy(isEqual);
+var isPlainObject__default = /*#__PURE__*/_interopDefaultLegacy(isPlainObject);
 
 /**
  * @file 公式内置函数
@@ -1077,9 +1079,9 @@ var Evaluator = /** @class */ (function () {
     /**
      * 对文本进行 HTML 转义
      *
-     * 示例 `ESCAPE("star")`
+     * 示例 `ESCAPE("<star>&")`
      *
-     * 返回 `Star`
+     * 返回 `&lt;start&gt;&amp;`
      *
      * @example ESCAPE(text)
      * @param {string} text - 文本
@@ -1676,8 +1678,27 @@ var Evaluator = /** @class */ (function () {
         if (!iterator || iterator.type !== 'anonymous_function') {
             throw new Error('expected an anonymous function get ' + iterator);
         }
-        return (Array.isArray(value) ? value : []).map(function (item, index) {
-            return _this.callAnonymousFunction(iterator, [item, index]);
+        return (Array.isArray(value) ? value : []).map(function (item, index, arr) {
+            return _this.callAnonymousFunction(iterator, [item, index, arr]);
+        });
+    };
+    /**
+     * 数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
+     * 将第二个箭头函数返回为 false 的成员过滤掉。
+     *
+     * @param {Array<any>} arr 数组
+     * @param {Function<any>} iterator 箭头函数
+     * @namespace 数组
+     * @example ARRAYFILTER(arr, item => item)
+     * @returns {boolean} 结果
+     */
+    Evaluator.prototype.fnARRAYFILTER = function (value, iterator) {
+        var _this = this;
+        if (!iterator || iterator.type !== 'anonymous_function') {
+            throw new Error('expected an anonymous function get ' + iterator);
+        }
+        return (Array.isArray(value) ? value : []).filter(function (item, index, arr) {
+            return _this.callAnonymousFunction(iterator, [item, index, arr]);
         });
     };
     /**
@@ -1769,6 +1790,31 @@ var Evaluator = /** @class */ (function () {
     Evaluator.prototype.fnUNIQ = function (arr, field) {
         return field ? uniqBy__default["default"](arr, field) : uniqWith__default["default"](arr, isEqual__default["default"]);
     };
+    /**
+     * 判断是否为类型支持：string, number, array, date, plain-object。
+     *
+     * @param {string} 判断对象
+     * @namespace 其他
+     * @example ISTYPE([{a: '1'}, {b: '2'}, {a: '1'}], 'array')
+     * @returns {boolean} 结果结果
+     */
+    Evaluator.prototype.fnISTYPE = function (target, type) {
+        switch (type) {
+            case 'string':
+                return typeof target === 'string';
+            case 'number':
+                return typeof target === 'number';
+            case 'array':
+                return Array.isArray(target);
+            case 'date':
+                return !!(target && target instanceof Date);
+            case 'plain-object':
+                return isPlainObject__default["default"](target);
+            case 'nil':
+                return !target;
+        }
+        return false;
+    };
     Evaluator.defaultFilters = {};
     return Evaluator;
 }());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amis-formula",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "负责 amis 里面的表达式实现，内置公式，编辑器等",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -100,5 +100,5 @@
       "printBasicPrototype": false
     }
   },
-  "gitHead": "af69249562f9de5efbd47fd5553bcdb73b2eab4f"
+  "gitHead": "cc2918e84d2a42f2ea459680891bc5543911aa65"
 }