util-helpers 4.18.0 → 4.19.0

package/esm/VERSION.js

@@ -1,4 +1,4 @@
-var VERSION = "4.18.0";
+var VERSION = "4.19.0";
 var VERSION$1 = VERSION;
 
 export { VERSION$1 as default };

package/esm/index.js

@@ -43,6 +43,7 @@ export { default as round } from './round.js';
 export { default as ajax } from './ajax.js';
 export { default as calculateCursorPosition } from './calculateCursorPosition.js';
 export { default as download } from './download.js';
+export { default as loadScript } from './loadScript.js';
 export { default as randomString } from './randomString.js';
 export { default as strlen } from './strlen.js';
 export { default as waitTime } from './waitTime.js';
@@ -56,6 +57,6 @@ export { default as findTreeSelect } from './findTreeSelect.js';
 export { setDisableWarning } from './utils/config.js';
 export { default as VERSION } from './VERSION.js';
 
-var version = "4.18.0";
+var version = "4.19.0";
 
 export { version };

package/esm/loadScript.js

@@ -0,0 +1,39 @@
+import { __rest, __assign } from 'tslib';
+
+function loadScript(src, options) {
+    return new Promise(function (resolve, reject) {
+        var head = document.head;
+        var script = document.createElement('script');
+        var _a = options || {}, attrs = _a.attrs, _b = _a.destroyOnError, destroyOnError = _b === void 0 ? true : _b, restOptions = __rest(_a, ["attrs", "destroyOnError"]);
+        var props = __assign(__assign({ async: true, type: 'text/javascript' }, restOptions), { src: src });
+        for (var key in props) {
+            if (key === 'onload' || key === 'onerror') {
+                continue;
+            }
+            script[key] = props[key];
+        }
+        if (typeof attrs === 'object') {
+            Object.keys(attrs).forEach(function (key) {
+                script.setAttribute(key, attrs[key]);
+            });
+        }
+        script.onload = function (ev) {
+            var _a;
+            this.onerror = this.onload = null;
+            (_a = props.onload) === null || _a === void 0 ? void 0 : _a.call(this, ev);
+            resolve(script);
+        };
+        script.onerror = function (ev) {
+            var _a;
+            this.onerror = this.onload = null;
+            (_a = props.onerror) === null || _a === void 0 ? void 0 : _a.call(this, ev);
+            if (destroyOnError) {
+                head.removeChild(script);
+            }
+            reject(new URIError('Failed to load ' + this.src));
+        };
+        head.appendChild(script);
+    });
+}
+
+export { loadScript as default };

package/lib/VERSION.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var VERSION = "4.18.0";
+var VERSION = "4.19.0";
 var VERSION$1 = VERSION;
 
 module.exports = VERSION$1;

package/lib/index.js

@@ -45,6 +45,7 @@ var round = require('./round.js');
 var ajax = require('./ajax.js');
 var calculateCursorPosition = require('./calculateCursorPosition.js');
 var download = require('./download.js');
+var loadScript = require('./loadScript.js');
 var randomString = require('./randomString.js');
 var strlen = require('./strlen.js');
 var waitTime = require('./waitTime.js');
@@ -58,7 +59,7 @@ var findTreeSelect = require('./findTreeSelect.js');
 var config = require('./utils/config.js');
 var VERSION = require('./VERSION.js');
 
-exports.version = "4.18.0";
+exports.version = "4.19.0";
 
 exports.isMobile = isMobile;
 exports.isTelephone = isTelephone;
@@ -105,6 +106,7 @@ exports.round = round;
 exports.ajax = ajax;
 exports.calculateCursorPosition = calculateCursorPosition;
 exports.download = download;
+exports.loadScript = loadScript;
 exports.randomString = randomString;
 exports.strlen = strlen;
 exports.waitTime = waitTime;

package/lib/loadScript.js

@@ -0,0 +1,41 @@
+'use strict';
+
+var tslib = require('tslib');
+
+function loadScript(src, options) {
+    return new Promise(function (resolve, reject) {
+        var head = document.head;
+        var script = document.createElement('script');
+        var _a = options || {}, attrs = _a.attrs, _b = _a.destroyOnError, destroyOnError = _b === void 0 ? true : _b, restOptions = tslib.__rest(_a, ["attrs", "destroyOnError"]);
+        var props = tslib.__assign(tslib.__assign({ async: true, type: 'text/javascript' }, restOptions), { src: src });
+        for (var key in props) {
+            if (key === 'onload' || key === 'onerror') {
+                continue;
+            }
+            script[key] = props[key];
+        }
+        if (typeof attrs === 'object') {
+            Object.keys(attrs).forEach(function (key) {
+                script.setAttribute(key, attrs[key]);
+            });
+        }
+        script.onload = function (ev) {
+            var _a;
+            this.onerror = this.onload = null;
+            (_a = props.onload) === null || _a === void 0 ? void 0 : _a.call(this, ev);
+            resolve(script);
+        };
+        script.onerror = function (ev) {
+            var _a;
+            this.onerror = this.onload = null;
+            (_a = props.onerror) === null || _a === void 0 ? void 0 : _a.call(this, ev);
+            if (destroyOnError) {
+                head.removeChild(script);
+            }
+            reject(new URIError('Failed to load ' + this.src));
+        };
+        head.appendChild(script);
+    });
+}
+
+module.exports = loadScript;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.18.0",
+  "version": "4.19.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -11,10 +11,6 @@
     "test": "jest --verbose",
     "test:coverage": "jest --coverage",
     "test:coverage:local": "cross-env COVERAGE_LOCAL=1 jest --coverage && open ./coverage/lcov-report/index.html",
-    "test:math": "jest --verbose test/math",
-    "test:type": "jest --verbose test/type",
-    "test:validator": "jest --verbose test/validator",
-    "test:processor": "jest --verbose test/processor",
     "build": "npm run build:module && npm run build:dist && npm run build:types",
     "build:module": "rm -rf esm && rm -rf lib && rollup -c rollup.module.config.mjs",
     "build:dist": "rm -rf dist && rollup -c rollup.umd.config.mjs",
@@ -97,6 +93,6 @@
   },
   "dependencies": {
     "tslib": "^2.5.0",
-    "ut2": "^1.0.0"
+    "ut2": "^1.0.2"
   }
 }

package/types/index.d.ts

@@ -100,6 +100,7 @@ export { default as round } from './round';
 export { default as ajax } from './ajax';
 export { default as calculateCursorPosition } from './calculateCursorPosition';
 export { default as download } from './download';
+export { default as loadScript } from './loadScript';
 export { default as randomString } from './randomString';
 export { default as strlen } from './strlen';
 export { default as waitTime } from './waitTime';

package/types/isPromiseLike.d.ts

@@ -1,6 +1,7 @@
 /**
  * 检测值是否类似Promise对象
  *
+ * @ignore
  * @static
  * @alias module:Validator.isPromiseLike
  * @since 3.8.0

package/types/loadScript.d.ts

@@ -0,0 +1,30 @@
+type ScriptAttribute = Pick<HTMLScriptElement, 'async' | 'crossOrigin' | 'defer' | 'integrity' | 'noModule' | 'referrerPolicy' | 'text' | 'type' | 'onload' | 'onerror' | 'id' | 'className'> & {
+    attrs: Record<string, string>;
+    destroyOnError: boolean;
+};
+/**
+ * 加载 js 文件。
+ *
+ * 默认属性 `async=true` `type=text/javascript` 。如果加载失败，默认会删除该 `script` 的 `dom` 标签。
+ *
+ * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+ *
+ * @static
+ * @alias module:Other.loadScript
+ * @since 4.19.0
+ * @param {string} src  js 地址。
+ * @param {Object} [options] script 标签属性。比如 `async` `defer` `onload` `onerror` `id` 等。如果需要设置属性，可以使用 `attrs` 。如果加载失败或错误不想删除，可以使用 `destroyOnError=false` 。
+ * @return {Promise<HTMLScriptElement>} 异步返回 script 元素。
+ * @example
+ *
+ * loadScript('some.js').then(script=>{
+ *   // do something
+ * })
+ *
+ * loadScript('some.js', { id: 'xxx', async: false, attrs: { foo: 'bar' } }).then(script=>{
+ *   // do something
+ * })
+ *
+ */
+declare function loadScript(src: string, options?: Partial<ScriptAttribute>): Promise<HTMLScriptElement>;
+export default loadScript;

package/types/normalizeString.d.ts

@@ -1,6 +1,7 @@
 /**
  * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
  *
+ * @ignore
  * @static
  * @alias module:Processor.normalizeString
  * @since 4.3.0

package/types/waitTime.d.ts

@@ -1,6 +1,7 @@
 /**
  * 等待时间返回 Promise 。常用于异步方法中延时。
  *
+ * @ignore
  * @static
  * @alias module:Other.waitTime
  * @since 4.2.0