util-helpers 4.16.2 → 4.17.0

package/esm/ajax.js

@@ -1,149 +1,53 @@
-import _typeof from "@babel/runtime/helpers/typeof";
-/**
- * @typedef {XMLHttpRequest['onloadstart']} XMLHttpRequestEvent XMLHttpRequest 事件对象
- */
-
-/**
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
- * @typedef {Object} AjaxOptions ajax配置项
- * @property {string} [method="get"] 创建请求时使用的方法
- * @property {Document | XMLHttpRequestBodyInit | null} [data=null] 请求体被发送的数据
- * @property {Object.<string, string>} [headers] 自定义请求头
- * @property {XMLHttpRequestResponseType} [responseType] 响应类型
- * @property {number} [timeout] 请求超时的毫秒数
- * @property {boolean} [withCredentials=false] 跨域请求时是否需要使用凭证
- * @property {boolean} [async=true] 是否异步执行操作
- * @property {string|null} [user=null] 用户名，用于认证用途
- * @property {string|null} [password=null] 密码，用于认证用途
- * @property {XMLHttpRequestEvent} [onLoadStart] 接收到响应数据时触发
- * @property {XMLHttpRequestEvent} [onProgress] 请求接收到更多数据时，周期性地触发
- * @property {XMLHttpRequestEvent} [onAbort] 当 request 被停止时触发，例如当程序调用 XMLHttpRequest.abort() 时
- * @property {XMLHttpRequestEvent} [onTimeout] 在预设时间内没有接收到响应时触发
- * @property {XMLHttpRequestEvent} [onError] 当 request 遭遇错误时触发
- * @property {XMLHttpRequestEvent} [onLoad] 请求成功完成时触发
- * @property {XMLHttpRequestEvent} [onLoadEnd] 请求结束时触发，无论请求成功 (load) 还是失败 (abort 或 error)
- */
-
-/**
- * 请求<br/><br/>
- * 
- * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
- * 
- * @static
- * @alias module:Other.ajax
- * @since 4.16.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
- * @param {string} url 地址
- * @param {AjaxOptions} [options] 配置项
- * @returns {Promise<ProgressEvent<EventTarget>>}
- * @example
- * ajax('/somefile').then(res=>{
- *   // do something
- * });
- * 
- * ajax('/api', { method: 'post' }).then(res=>{
- *   // do something
- * });
- */
 function ajax(url, options) {
-  var _ref = options || {},
-    _ref$method = _ref.method,
-    method = _ref$method === void 0 ? 'get' : _ref$method,
-    _ref$data = _ref.data,
-    data = _ref$data === void 0 ? null : _ref$data,
-    timeout = _ref.timeout,
-    headers = _ref.headers,
-    _ref$withCredentials = _ref.withCredentials,
-    withCredentials = _ref$withCredentials === void 0 ? false : _ref$withCredentials,
-    _ref$async = _ref.async,
-    async = _ref$async === void 0 ? true : _ref$async,
-    _ref$user = _ref.user,
-    user = _ref$user === void 0 ? null : _ref$user,
-    _ref$password = _ref.password,
-    password = _ref$password === void 0 ? null : _ref$password,
-    responseType = _ref.responseType,
-    onAbort = _ref.onAbort,
-    onError = _ref.onError,
-    onLoad = _ref.onLoad,
-    onLoadEnd = _ref.onLoadEnd,
-    onLoadStart = _ref.onLoadStart,
-    onProgress = _ref.onProgress,
-    onTimeout = _ref.onTimeout;
-  return new Promise(function (resolve, reject) {
-    var xhr = new XMLHttpRequest();
-    xhr.open(method.toLowerCase(), url, async, user, password);
-
-    // 设置请求超时
-    if (typeof timeout === 'number' && timeout > 0) {
-      xhr.timeout = timeout;
-    }
-
-    // 跨域请求时是否需要使用凭证
-    xhr.withCredentials = withCredentials;
-
-    // 设置响应类型
-    if (responseType) {
-      xhr.responseType = responseType;
-    }
-
-    // 设置请求头
-    if (_typeof(headers) === 'object') {
-      Object.keys(headers).map(function (item) {
-        xhr.setRequestHeader(item, headers[item]);
-      });
-    }
-
-    /**
-     * 请求成功异步调用
-     * @param {XMLHttpRequestEvent} [cb] 回调方法
-     */
-    var wrapSuccess = function wrapSuccess(cb) {
-      /**
-       * 内部方法
-       * @param {ProgressEvent<EventTarget>} e 事件对象
-       */
-      return function (e) {
-        resolve(e);
-        cb === null || cb === void 0 ? void 0 : cb.call(xhr, e);
-      };
-    };
-
-    /**
-     * 请求失败（中断/超时/失败）处理
-       * @param {XMLHttpRequestEvent} [cb] 回调方法
-     */
-    var wrapError = function wrapError(cb) {
-      /**
-       * 内部方法
-       * @param {ProgressEvent<EventTarget>} e 事件对象
-       */
-      return function (e) {
-        reject(e);
-        cb === null || cb === void 0 ? void 0 : cb.call(xhr, e);
-      };
-    };
-
-    // 事件处理
-    /**@type {Object.<keyof XMLHttpRequestEventTargetEventMap, XMLHttpRequestEvent | undefined>} */
-    var events = {
-      loadstart: onLoadStart,
-      progress: onProgress,
-      abort: wrapError(onAbort),
-      timeout: wrapError(onTimeout),
-      error: wrapError(onError),
-      load: wrapSuccess(onLoad),
-      loadend: onLoadEnd
-    };
-    /**@type {(keyof XMLHttpRequestEventTargetEventMap)[]} */
-    // @ts-ignore
-    var eventNames = Object.keys(events);
-    eventNames.map(function (item) {
-      var func = events[item];
-      if (func) {
-        xhr.addEventListener(item, func);
-      }
+    var _a = options || {}, _b = _a.method, method = _b === void 0 ? 'get' : _b, _c = _a.data, data = _c === void 0 ? null : _c, timeout = _a.timeout, headers = _a.headers, _d = _a.withCredentials, withCredentials = _d === void 0 ? false : _d, _e = _a.async, async = _e === void 0 ? true : _e, _f = _a.user, user = _f === void 0 ? null : _f, _g = _a.password, password = _g === void 0 ? null : _g, responseType = _a.responseType, onReadyStateChange = _a.onReadyStateChange, onLoadStart = _a.onLoadStart, onProgress = _a.onProgress, onAbort = _a.onAbort, onTimeout = _a.onTimeout, onError = _a.onError, onLoad = _a.onLoad, onLoadEnd = _a.onLoadEnd;
+    return new Promise(function (resolve, reject) {
+        var xhr = new XMLHttpRequest();
+        xhr.open(method.toLowerCase(), url, async, user, password);
+        if (onReadyStateChange) {
+            xhr.onreadystatechange = onReadyStateChange;
+        }
+        if (typeof timeout === 'number' && timeout > 0) {
+            xhr.timeout = timeout;
+        }
+        xhr.withCredentials = withCredentials;
+        if (responseType) {
+            xhr.responseType = responseType;
+        }
+        if (typeof headers === 'object') {
+            Object.keys(headers).map(function (item) {
+                xhr.setRequestHeader(item, headers[item]);
+            });
+        }
+        var wrapSuccess = function (cb) {
+            return function (e) {
+                resolve(e);
+                cb === null || cb === void 0 ? void 0 : cb.call(xhr, e);
+            };
+        };
+        var wrapError = function (cb) {
+            return function (e) {
+                reject(e);
+                cb === null || cb === void 0 ? void 0 : cb.call(xhr, e);
+            };
+        };
+        var events = {
+            loadstart: onLoadStart,
+            progress: onProgress,
+            abort: wrapError(onAbort),
+            timeout: wrapError(onTimeout),
+            error: wrapError(onError),
+            load: wrapSuccess(onLoad),
+            loadend: onLoadEnd
+        };
+        var eventKeys = Object.keys(events);
+        eventKeys.map(function (item) {
+            var func = events[item];
+            if (func) {
+                xhr.addEventListener(item, func);
+            }
+        });
+        xhr.send(data);
     });
-    xhr.send(data);
-  });
 }
-export default ajax;
+
+export { ajax as default };

package/esm/blobToDataURL.js

@@ -1,37 +1,7 @@
-//  file、blob文件如何预览图片？
-//  方法1：将file或者blob类型文件转成base64数据，再作为src赋值给img标签
-//  方法2：使用 window.URL.createObjectURL(blob) 为blob、file 创建一个指向该参数对象的URL
+import fileReader from './fileReader.js';
 
-import fileReader from "./fileReader";
-
-/**
- * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串<br/><br/>
- * 
- * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
- *
- * @ignore
- * @static
- * @alias module:Processor.blobToDataURL
- * @since 4.1.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
- * @deprecated 请使用 `fileReader` 方法
- * @param {Blob} blob Blob 或 File 对象
- * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
- * @example
- * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
- * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
- *
- * blobToDataURL(htmlBlob).then(data=>{
- *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
- * });
- *
- * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
- *
- * blobToDataURL(textBlob).then(data=>{
- *   console.log(data); // data:text/plain;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
- * });
- */
 function blobToDataURL(blob) {
-  return fileReader(blob);
+    return fileReader(blob);
 }
-export default blobToDataURL;
+
+export { blobToDataURL as default };

package/esm/bytesToSize.js

@@ -1,38 +1,13 @@
-/**
- * 字节转换存储单位，保留2位小数点
- *
- * @static
- * @alias module:Processor.bytesToSize
- * @since 3.8.0
- * @param {number} bytes 字节大小
- * @param {Object} [options] 配置项
- * @param {string} [options.spaceMark=' '] 间隔字符
- * @param {number} [options.precision=2] 精度
- * @returns {string} 存储单位值
- * @example
- *
- * bytesToSize(0); // 0 B
- * bytesToSize(1024); // 1 KB
- * bytesToSize(3.213243*1024*1024); // 3.21 MB
- * bytesToSize(1024*1024*1024); // 1 GB
- * 
- * // 自定义间隔符号
- * bytesToSize(0, { spaceMark: '' }); // 0B
- * bytesToSize(1024, { spaceMark: '' }); // 1KB
- * 
- */
-function bytesToSize(bytes) {
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  var _options$spaceMark = options.spaceMark,
-    spaceMark = _options$spaceMark === void 0 ? ' ' : _options$spaceMark,
-    _options$precision = options.precision,
-    precision = _options$precision === void 0 ? 2 : _options$precision;
-  var numBytes = typeof bytes !== 'number' ? Number(bytes) : bytes;
-  if (numBytes === 0 || isNaN(numBytes)) return "0".concat(spaceMark, "B");
-  var k = 1024;
-  // 存储单位
-  var sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
-  var i = Math.floor(Math.log(numBytes) / Math.log(k));
-  return sizes[i] ? "".concat(Number((numBytes / Math.pow(k, i)).toFixed(precision))).concat(spaceMark).concat(sizes[i]) : numBytes + '';
+function bytesToSize(bytes, options) {
+    if (options === void 0) { options = {}; }
+    var _a = options.spaceMark, spaceMark = _a === void 0 ? ' ' : _a, _b = options.precision, precision = _b === void 0 ? 2 : _b;
+    var numBytes = typeof bytes !== 'number' ? Number(bytes) : bytes;
+    if (numBytes === 0 || isNaN(numBytes))
+        return "0".concat(spaceMark, "B");
+    var k = 1024;
+    var sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+    var i = Math.floor(Math.log(numBytes) / Math.log(k));
+    return sizes[i] ? "".concat(Number((numBytes / Math.pow(k, i)).toFixed(precision))).concat(spaceMark).concat(sizes[i]) : numBytes + '';
 }
-export default bytesToSize;
+
+export { bytesToSize as default };

package/esm/calculateCursorPosition.js

@@ -1,55 +1,33 @@
-import normalizeString from './normalizeString';
+import normalizeString from './normalizeString.js';
 
-// ref: https://github.com/ant-design/ant-design-mobile/blob/v2/components/input-item/index.tsx#L240
-
-/**
- * 计算输入框的值格式化后光标位置
- *
- * @static
- * @alias module:Other.calculateCursorPosition
- * @since 4.6.0
- * @see {@link https://2950v9.csb.app/|h5示例}
- * @see {@link https://33ccy9.csb.app/|react示例}
- * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
- * @param {string} prevCtrlValue 上一个格式化后的值
- * @param {string} rawValue 当前输入原值
- * @param {string} ctrlValue 当前格式化后的值
- * @param {Object} [options] 配置项
- * @param {string[]|string} [options.placeholderChar=' '] 占位符
- * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字，意味着 ctrlValue 需要去掉非数字。
- * @param {'mobile'|'bankCard'} [options.type] 格式化类型，内置手机号码和银行卡号特殊处理
- * @returns {number} 格式化后的光标位置
- */
-function calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue) {
-  var options = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
-  var _options$placeholderC = options.placeholderChar,
-    placeholderChar = _options$placeholderC === void 0 ? ' ' : _options$placeholderC,
-    _options$maskReg = options.maskReg,
-    maskReg = _options$maskReg === void 0 ? /\D/g : _options$maskReg,
-    type = options.type;
-  var realCtrlValue = normalizeString(prevCtrlValue);
-  var realRawValue = normalizeString(rawValue);
-  var placeholderChars = Array.isArray(placeholderChar) ? placeholderChar : [placeholderChar];
-  var editLength = realRawValue.length - realCtrlValue.length;
-  var isAddition = editLength > 0;
-  var pos = prevPos;
-  if (isAddition) {
-    var additionStr = realRawValue.substring(pos - editLength, pos);
-    var ctrlCharCount = additionStr.replace(maskReg, '').length;
-    pos -= editLength - ctrlCharCount;
-    var placeholderCharCount = 0;
-    while (ctrlCharCount > 0) {
-      if (placeholderChars.indexOf(ctrlValue.charAt(pos - ctrlCharCount + placeholderCharCount)) !== -1) {
-        placeholderCharCount++;
-      } else {
-        ctrlCharCount--;
-      }
+function calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue, options) {
+    if (options === void 0) { options = {}; }
+    var _a = options.placeholderChar, placeholderChar = _a === void 0 ? ' ' : _a, _b = options.maskReg, maskReg = _b === void 0 ? /\D/g : _b, type = options.type;
+    var realCtrlValue = normalizeString(prevCtrlValue);
+    var realRawValue = normalizeString(rawValue);
+    var placeholderChars = Array.isArray(placeholderChar) ? placeholderChar : [placeholderChar];
+    var editLength = realRawValue.length - realCtrlValue.length;
+    var isAddition = editLength > 0;
+    var pos = prevPos;
+    if (isAddition) {
+        var additionStr = realRawValue.substring(pos - editLength, pos);
+        var ctrlCharCount = additionStr.replace(maskReg, '').length;
+        pos -= editLength - ctrlCharCount;
+        var placeholderCharCount = 0;
+        while (ctrlCharCount > 0) {
+            if (placeholderChars.indexOf(ctrlValue.charAt(pos - ctrlCharCount + placeholderCharCount)) !== -1) {
+                placeholderCharCount++;
+            }
+            else {
+                ctrlCharCount--;
+            }
+        }
+        pos += placeholderCharCount;
+    }
+    if ((type === 'mobile' && (pos === 4 || pos === 9)) || (type === 'bankCard' && pos > 0 && pos % 5 === 0)) {
+        pos -= 1;
     }
-    pos += placeholderCharCount;
-  }
-  if (type === 'mobile' && (pos === 4 || pos === 9) || type === 'bankCard' && pos > 0 && pos % 5 === 0) {
-    pos -= 1;
-  }
-  return pos;
+    return pos;
 }
-export default calculateCursorPosition;
+
+export { calculateCursorPosition as default };

package/esm/dataURLToBlob.js

@@ -1,29 +1,15 @@
-/**
- * 将 DataURL 转为 Blob 对象
- *
- * @static
- * @alias module:Processor.dataURLToBlob
- * @since 4.1.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
- * @param {string} dataurl data: 协议的URL
- * @returns {Blob} Blob 对象
- * @example
- * const dataurl = 'data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
- * dataURLToBlob(dataurl); // Blob {size: 32, type: 'text/html'}
- */
-function dataURLToBlob(dataurl) {
-  var parts = dataurl.split(',');
-  var meta = parts[0].substring(5).split(';');
-  var type = meta[0];
-  var decoder = meta.indexOf('base64') !== -1 ? atob : decodeURIComponent;
-  var bstr = decoder(parts[1]);
-  var n = bstr.length;
-  var u8arr = new Uint8Array(n);
-  while (n--) {
-    u8arr[n] = bstr.charCodeAt(n);
-  }
-  return new Blob([u8arr], {
-    type: type
-  });
+function dataURLToBlob(data) {
+    var parts = data.split(',');
+    var meta = parts[0].substring(5).split(';');
+    var type = meta[0];
+    var decoder = meta.indexOf('base64') !== -1 ? atob : decodeURIComponent;
+    var bstr = decoder(parts[1]);
+    var n = bstr.length;
+    var u8arr = new Uint8Array(n);
+    while (n--) {
+        u8arr[n] = bstr.charCodeAt(n);
+    }
+    return new Blob([u8arr], { type: type });
 }
-export default dataURLToBlob;
+
+export { dataURLToBlob as default };

package/esm/divide.js

@@ -1,51 +1,27 @@
-import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import { strip, digitLength, float2Fixed, checkBoundary, transformEffectiveNumber } from './utils/math.util';
-import times from './times';
+import { __read, __spreadArray } from 'tslib';
+import { transformEffectiveNumber, float2Fixed, checkBoundary, strip, digitLength } from './utils/math.util.js';
+import times from './times.js';
+import _isNaN from './utils/type/isNaN.js';
 
-/**
- * 精确除法，支持多个数相除，除数默认为 1 。
- *
- * @static
- * @alias module:Math.divide
- * @since 3.1.0
- * @param {...number|string} nums 被除数和除数
- * @returns {number} 商数
- * @example
- *
- * divide(1.21); // 1.21 除数默认为 1 ，即 1.21/1 = 1.21
- * divide(1.21, 1.1); // 1.1
- * divide(1000, 10, 10); // 10
- * divide(1000, 10, 10, 10); // 1
- * 
- * divide(); // NaN  如果没有传入参数，被除数默认为 undefined 。 Number(undefined) 转换为 NaN ，NaN/1 = NaN
- * divide(null); // 0  Number(null) 转换为 0 ， 0/1 = 0
- * divide('1.5 ', 0.5); // 3  Number('1.5 ') 转换为 1.5 ，1.5/0.5 = 3
- * 
- */
 function divide() {
-  for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
-    nums[_key] = arguments[_key];
-  }
-  var num1 = nums[0],
-    _nums$ = nums[1],
-    num2 = _nums$ === void 0 ? 1 : _nums$,
-    rest = nums.slice(2);
-  if (rest.length > 0) {
-    return divide.apply(void 0, [divide(num1, num2)].concat(_toConsumableArray(rest)));
-  }
-  num1 = transformEffectiveNumber(num1);
-  num2 = transformEffectiveNumber(num2);
-
-  // 兼容处理，如果参数包含无效数值时，返回 NaN
-  // @ts-ignore
-  if (isNaN(num1) || isNaN(num2)) {
-    return Number.NaN;
-  }
-  var num1Changed = float2Fixed(num1);
-  var num2Changed = float2Fixed(num2);
-  checkBoundary(num1Changed);
-  checkBoundary(num2Changed);
-  // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
-  return times(num1Changed / num2Changed, strip(Math.pow(10, digitLength(num2) - digitLength(num1))));
+    var nums = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        nums[_i] = arguments[_i];
+    }
+    var _a = __read(nums), num1 = _a[0], _b = _a[1], num2 = _b === void 0 ? 1 : _b, rest = _a.slice(2);
+    if (rest.length > 0) {
+        return divide.apply(void 0, __spreadArray([divide(num1, num2)], __read(rest), false));
+    }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
+    if (_isNaN(num1) || _isNaN(num2)) {
+        return Number.NaN;
+    }
+    var num1Changed = float2Fixed(num1);
+    var num2Changed = float2Fixed(num2);
+    checkBoundary(num1Changed);
+    checkBoundary(num2Changed);
+    return times(num1Changed / num2Changed, strip(Math.pow(10, digitLength(num2) - digitLength(num1))));
 }
-export default divide;
+
+export { divide as default };