util-helpers 4.16.2 → 4.17.0

package/esm/download.js

@@ -1,171 +1,90 @@
-import _typeof from "@babel/runtime/helpers/typeof";
-// 如果修改文档，请同步修改 interface.doc.js
+import { __awaiter, __generator } from 'tslib';
+import dataURLToBlob from './dataURLToBlob.js';
+import isUrl from './isUrl.js';
+import ajax from './ajax.js';
+import isBlob from './utils/type/isBlob.js';
+import isPromiseLike from './isPromiseLike.js';
 
-import dataURLToBlob from "./dataURLToBlob";
-import isUrl from "./isUrl";
-import ajax from "./ajax";
-import { isBlob } from "./utils/type";
-import isPromiseLike from "./isPromiseLike";
-
-/**
- * 下载文件
- * 
- * @param {string} blobUrl blob 地址
- * @param {string} [fileName] 文件名称
- */
 function saver(blobUrl, fileName) {
-  var anchor = document.createElement('a');
-  // anchor.href = decodeURIComponent(blobUrl);
-  anchor.href = blobUrl;
-  anchor.style.display = 'none';
-  anchor.setAttribute('download', fileName || '');
-
-  /**
-   * 处理点击事件，防止事件冒泡到 body/html 的点击事件。
-   * 
-   * @param {MouseEvent} e 鼠标事件对象
-   */
-  function handleClick(e) {
-    e.stopPropagation();
-    anchor.removeEventListener('click', handleClick);
-  }
-  anchor.addEventListener('click', handleClick);
-  document.body.appendChild(anchor);
-  anchor.click();
-  document.body.removeChild(anchor);
+    if (fileName === void 0) { fileName = ''; }
+    var anchor = document.createElement('a');
+    anchor.href = blobUrl;
+    anchor.style.display = 'none';
+    anchor.setAttribute('download', fileName);
+    function handleClick(e) {
+        e.stopPropagation();
+        anchor.removeEventListener('click', handleClick);
+    }
+    anchor.addEventListener('click', handleClick);
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
 }
-
-/**
- * @typedef {import('./ajax.js').AjaxOptions} AjaxOptions ajax 配置项
- */
-
-/**
- * @callback TransformRequest
- * @param {AjaxOptions} options ajax 配置项
- * @returns {AjaxOptions | Promise<AjaxOptions>}
- */
-
-/**
- * @callback TransformResponse
- * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
- * @returns {Blob | Promise<Blob>}
- */
-
-/**
- * @typedef {Object} DownloadOptions 下载配置项
- * @property {string} [options.fileName] 文件名称
- * @property {string} [options.type] MIME 类型
- * @property {'url'|'text'} [options.dataType] 手动设置数据类型，默认会根据传入的数据判断类型，主要是为了区分 url 和 text 。<br/>如果你要下载的文本是 url ，请设置 'text' ；如果你要下载的 url 是绝对/相对路径，请设置 'url' 。
- * @property {TransformRequest} [options.transformRequest] 请求前触发，XHR 对象或配置调整
- * @property {TransformResponse} [options.transformResponse] 请求成功后触发，在传递给 then/catch 前，允许修改响应数据
- */
-
-/**
- * 下载<br/><br/>
- * 
- * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端，兼容 IE10+ 和现代浏览器。</em>
- * 
- * @static
- * @alias module:Other.download
- * @since 4.16.0
- * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展|MIME}
- * @see {@link https://9ykc9s.csb.app/|在线示例}
- * @param {string|Blob|ArrayBuffer|Int8Array|Uint8Array|Uint8ClampedArray|Int16Array|Uint16Array|Int32Array|Uint32Array|Float32Array|Float64Array|BigInt64Array|BigUint64Array} data 字符串、blob数据或url地址
- * @param {string|DownloadOptions} [options] 文件名称 或 配置项
- * @returns {Promise<void>}
- * @example
- * // 文本
- * download('hello world', 'text.txt');
- * 
- * // 远程文件
- * download('/xxx.jpg', { dataType: 'url' });
- * 
- * // blob文件
- * download(new Blob(['hello world']), 'text.txt');
- * 
- */
 function download(data, options) {
-  var config = _typeof(options) === 'object' ? options : {};
-  if (typeof options === 'string') {
-    config.fileName = options;
-  }
-  var fileName = config.fileName,
-    type = config.type,
-    dataType = config.dataType,
-    transformRequest = config.transformRequest,
-    transformResponse = config.transformResponse;
-
-  /** @type {Blob|undefined} */
-  var payload;
-
-  // dataURLs、blob url、url、string
-  if (typeof data === 'string') {
-    if (!dataType && /^blob:.*?\/.*/.test(data)) {
-      // blob url
-      saver(data, fileName);
-      return Promise.resolve();
-    } else if (!dataType && /^data:([\w+-]+\/[\w+.-]+)?[,;]/.test(data)) {
-      // dataURLs
-      payload = dataURLToBlob(data);
-    } else if (dataType === 'url' || !dataType && isUrl(data)) {
-      // url
-      // 包装为异步方法
-      /** @type {(opts: AjaxOptions)=>Promise<AjaxOptions>} */
-      var asyncTransformRequest = function asyncTransformRequest(opts) {
-        // 请求前配置调整
-        var tempOptions = typeof transformRequest === 'function' ? transformRequest(opts) : opts;
-        // @ts-ignore
-        return isPromiseLike(tempOptions) ? tempOptions : Promise.resolve(tempOptions);
-      };
-      /** @type {(res: Blob)=>Promise<Blob>} */
-      var asyncTransformResponse = function asyncTransformResponse(res) {
-        var tempRes = typeof transformResponse === 'function' ? transformResponse(res) : res;
-        // @ts-ignore
-        return isPromiseLike(tempRes) ? tempRes : Promise.resolve(tempRes);
-      };
-
-      // 此处如果使用 async/await 语法糖，编译后的umd代码过大
-      return asyncTransformRequest({
-        responseType: 'blob'
-      }).then(function (ajaxOptions) {
-        return ajax(data, ajaxOptions).then(function (e) {
-          // @ts-ignore
-          return asyncTransformResponse(e.target.response).then(function (res) {
-            var currentFileName = fileName || data.split("?")[0].split("#")[0].split("/").pop();
-            return download(res, {
-              fileName: currentFileName,
-              type: type || (isBlob(res) ? res.type : undefined)
-            });
-          });
+    return __awaiter(this, void 0, void 0, function () {
+        var config, fileName, type, dataType, transformRequest, transformResponse, payload, asyncTransformRequest, asyncTransformResponse, ajaxOptions, ev, res, currentFileName, url;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    config = typeof options === 'object' ? options : {};
+                    if (typeof options === 'string') {
+                        config.fileName = options;
+                    }
+                    fileName = config.fileName, type = config.type, dataType = config.dataType, transformRequest = config.transformRequest, transformResponse = config.transformResponse;
+                    if (!(typeof data === 'string')) return [3, 8];
+                    if (!(!dataType && /^blob:.*?\/.*/.test(data))) return [3, 1];
+                    saver(data, fileName);
+                    return [2, Promise.resolve()];
+                case 1:
+                    if (!(!dataType && /^data:([\w+-]+\/[\w+.-]+)?[,;]/.test(data))) return [3, 2];
+                    payload = dataURLToBlob(data);
+                    return [3, 7];
+                case 2:
+                    if (!(dataType === 'url' || (!dataType && isUrl(data)))) return [3, 6];
+                    asyncTransformRequest = function (opts) {
+                        var tempOptions = typeof transformRequest === 'function' ? transformRequest(opts) : opts;
+                        return isPromiseLike(tempOptions) ? tempOptions : Promise.resolve(tempOptions);
+                    };
+                    asyncTransformResponse = function (res) {
+                        var tempRes = typeof transformResponse === 'function' ? transformResponse(res) : res;
+                        return isPromiseLike(tempRes) ? tempRes : Promise.resolve(tempRes);
+                    };
+                    return [4, asyncTransformRequest({ responseType: 'blob' })];
+                case 3:
+                    ajaxOptions = _a.sent();
+                    return [4, ajax(data, ajaxOptions)];
+                case 4:
+                    ev = _a.sent();
+                    return [4, asyncTransformResponse(ev.target.response)];
+                case 5:
+                    res = _a.sent();
+                    currentFileName = fileName || data.split('?')[0].split('#')[0].split('/').pop();
+                    return [2, download(res, { fileName: currentFileName, type: type || (isBlob(res) ? res.type : undefined) })];
+                case 6:
+                    payload = new Blob([data], { type: type || 'text/plain' });
+                    _a.label = 7;
+                case 7: return [3, 9];
+                case 8:
+                    if (data instanceof Blob) {
+                        payload = data;
+                    }
+                    _a.label = 9;
+                case 9:
+                    if (!payload) {
+                        payload = new Blob([data], { type: type });
+                    }
+                    if (navigator.msSaveBlob) {
+                        navigator.msSaveBlob(payload, fileName || 'download');
+                    }
+                    else {
+                        url = URL.createObjectURL(payload);
+                        saver(url, fileName);
+                        URL.revokeObjectURL(url);
+                    }
+                    return [2, Promise.resolve()];
+            }
         });
-      });
-    } else {
-      // string
-      payload = new Blob([data], {
-        type: type || 'text/plain'
-      });
-    }
-  } else if (isBlob(data)) {
-    // @ts-ignore
-    payload = data;
-  }
-
-  // html、TypedArray
-  if (!(payload instanceof Blob)) {
-    payload = new Blob([data], {
-      type: type
     });
-  }
-
-  // @ts-ignore
-  if (navigator.msSaveBlob) {
-    // @ts-ignore
-    navigator.msSaveBlob(payload, fileName || 'download');
-  } else {
-    var url = URL.createObjectURL(payload);
-    saver(url, fileName);
-    URL.revokeObjectURL(url);
-  }
-  return Promise.resolve();
 }
-export default download;
+
+export { download as default };

package/esm/fileReader.js

@@ -1,67 +1,21 @@
 var FileReaderMethodMap = {
-  arrayBuffer: 'readAsArrayBuffer',
-  binaryString: 'readAsBinaryString',
-  dataURL: 'readAsDataURL',
-  text: 'readAsText'
+    arrayBuffer: 'readAsArrayBuffer',
+    binaryString: 'readAsBinaryString',
+    dataURL: 'readAsDataURL',
+    text: 'readAsText'
 };
-
-/**
- * @overload
- * @param {Blob} blob
- * @param {'arrayBuffer'} type
- * @returns {Promise<ArrayBuffer>}
- */
-
-/**
- * @overload
- * @param {Blob} blob
- * @param {'binaryString'|'binaryString'|'dataURL'|'text'} [type='dataURL']
- * @returns {Promise<string>}
- */
-
-/**
- * 读取 Blob 或 File 对象，转为 Base64/String/ArrayBuffer<br/><br/>
- * 
- * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
- *
- * @static
- * @alias module:Processor.fileReader
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader|FileReader}
- * @since 4.16.0
- * @param {Blob} blob Blob 或 File 对象
- * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] Blob 或 File 对象
- * @returns {Promise<string|ArrayBuffer>} 文件的内容
- * @example
- * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
- * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
- *
- * fileReader(htmlBlob).then(data=>{
- *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
- * });
- *
- * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
- *
- * fileReader(textBlob, 'text').then(data=>{
- *   console.log(data); // <a id="a"><b id="b">hey!</b></a>
- * });
- */
-function fileReader(blob) {
-  var type = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'dataURL';
-  var method = FileReaderMethodMap[type];
-  if (!method) {
-    method = FileReaderMethodMap.dataURL;
-  }
-  return new Promise(function (resolve, reject) {
-    var reader = new FileReader();
-    // @ts-ignore
-    reader[method](blob);
-    // @ts-ignore
-    reader.onload = function () {
-      return resolve(reader.result);
-    };
-    reader.onerror = function (error) {
-      return reject(error);
-    };
-  });
+function fileReader(blob, type) {
+    if (type === void 0) { type = 'dataURL'; }
+    var method = FileReaderMethodMap[type];
+    if (!method) {
+        method = FileReaderMethodMap.dataURL;
+    }
+    return new Promise(function (resolve, reject) {
+        var reader = new FileReader();
+        reader[method](blob);
+        reader.onload = function () { return resolve(reader.result); };
+        reader.onerror = function (error) { return reject(error); };
+    });
 }
-export default fileReader;
+
+export { fileReader as default };

package/esm/filterTree.js

@@ -1,59 +1,29 @@
-import _objectSpread from "@babel/runtime/helpers/objectSpread2";
-import { isObject } from "./utils/type";
+import { __assign } from 'tslib';
+import isObject from './utils/type/isObject.js';
 
-/**
- * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
- * 
- * @static
- * @alias module:Tree.filterTree
- * @since 4.15.0
- * @template {any} T
- * @template {(item: T) => boolean} F
- * @param {T[]} tree 树结构数据
- * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，结果将包含该节点
- * @param {string} [childrenField='children'] 子级字段名
- * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
- * @returns {T[]}
- * @example
- * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
- * 
- * filterTree(menus, item=>item.name.indexOf('管理') > -1);
- * // [{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
- * 
- * // 如果某节点被过滤掉，它的子节点也一并抛弃
- * filterTree(menus, item=>item.id === '7');
- * // []
- * 
- * filterTree(menus, item=>item.id === 'not found');
- * // []
- */
-function filterTree(tree, predicate) {
-  var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
-  var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
-  /** @type {T[]} */
-  var result = [];
-  if (!Array.isArray(tree)) {
-    return result;
-  }
-  tree.forEach(function (item) {
-    var newItem = item;
-    if (isObject(item)) {
-      // @ts-ignore
-      newItem = nodeAssign === 'spread' ? _objectSpread({}, item) : item;
+function filterTree(tree, predicate, childrenField, nodeAssign) {
+    if (childrenField === void 0) { childrenField = 'children'; }
+    if (nodeAssign === void 0) { nodeAssign = 'spread'; }
+    var result = [];
+    if (!Array.isArray(tree)) {
+        return result;
     }
-    if (predicate(newItem)) {
-      if (isObject(newItem)) {
-        /** @type {T[]|undefined} */
-        // @ts-ignore
-        var childs = newItem[childrenField];
-        if (Array.isArray(childs) && childs.length > 0) {
-          // @ts-ignore
-          newItem[childrenField] = filterTree(childs, predicate, childrenField, nodeAssign);
+    tree.forEach(function (item) {
+        var newItem = item;
+        if (isObject(item)) {
+            newItem = nodeAssign === 'spread' ? __assign({}, item) : item;
         }
-      }
-      result.push(newItem);
-    }
-  });
-  return result;
+        if (predicate(newItem)) {
+            if (isObject(newItem)) {
+                var childs = newItem[childrenField];
+                if (Array.isArray(childs) && childs.length > 0) {
+                    newItem[childrenField] = filterTree(childs, predicate, childrenField, nodeAssign);
+                }
+            }
+            result.push(newItem);
+        }
+    });
+    return result;
 }
-export default filterTree;
+
+export { filterTree as default };

package/esm/findTreeNode.js

@@ -1,72 +1,44 @@
-import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import _createForOfIteratorHelper from "@babel/runtime/helpers/createForOfIteratorHelper";
-import { isObject } from "./utils/type";
+import { __values, __spreadArray, __read } from 'tslib';
+import isObject from './utils/type/isObject.js';
 
-/**
- * 查找树结构数据节点
- * 
- * @static
- * @alias module:Tree.findTreeNode
- * @since 4.14.0
- * @template {any} T
- * @template {(item: T) => boolean} F
- * @param {T[]} tree 树结构数据
- * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，将返回该节点
- * @param {string} [childrenField='children'] 子级字段名
- * @returns {T|undefined}
- * @example
- * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
- * 
- * findTreeNode(menus, item=>item.id === '2');
- * // {"id":"2","name":"交易管理","code":"trade","pid":null,"children":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","children":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]}
- * 
- * findTreeNode(menus, item=>item.id === '7');
- * // {"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}
- * 
- * findTreeNode(menus, item=>item.id === 'not found');
- * // undefined
- */
-function findTreeNode(tree, predicate) {
-  var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
-  var stack = [];
-
-  /** @type {T|undefined} */
-  var node;
-  if (!Array.isArray(tree)) {
-    return node;
-  }
-  var _iterator = _createForOfIteratorHelper(tree),
-    _step;
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var item = _step.value;
-      stack.push(item);
-      while (stack.length) {
-        /** @type {T} */
-        // @ts-ignore
-        var temp = stack.pop();
-        if (predicate(temp)) {
-          node = temp;
-          break;
+function findTreeNode(tree, predicate, childrenField) {
+    var e_1, _a;
+    if (childrenField === void 0) { childrenField = 'children'; }
+    var stack = [];
+    var node;
+    if (!Array.isArray(tree)) {
+        return node;
+    }
+    try {
+        for (var tree_1 = __values(tree), tree_1_1 = tree_1.next(); !tree_1_1.done; tree_1_1 = tree_1.next()) {
+            var item = tree_1_1.value;
+            stack.push(item);
+            while (stack.length) {
+                var temp = stack.pop();
+                if (predicate(temp)) {
+                    node = temp;
+                    break;
+                }
+                if (isObject(temp)) {
+                    var childs = temp[childrenField];
+                    if (Array.isArray(childs) && childs.length > 0) {
+                        stack.push.apply(stack, __spreadArray([], __read(childs), false));
+                    }
+                }
+            }
+            if (node) {
+                break;
+            }
         }
-        if (isObject(temp)) {
-          /** @type {T[]} */
-          // @ts-ignore
-          var childs = temp[childrenField];
-          if (Array.isArray(childs) && childs.length > 0) {
-            stack.push.apply(stack, _toConsumableArray(childs));
-          }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (tree_1_1 && !tree_1_1.done && (_a = tree_1.return)) _a.call(tree_1);
         }
-      }
-      if (node) {
-        break;
-      }
+        finally { if (e_1) throw e_1.error; }
     }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
-  }
-  return node;
+    return node;
 }
-export default findTreeNode;
+
+export { findTreeNode as default };