sculp-js 1.4.0 → 1.5.0

package/lib/umd/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
@@ -42,6 +42,20 @@
     const isDate = (any) => typeIs(any) === 'Date';
     const isError = (any) => typeIs(any) === 'Error';
     const isRegExp = (any) => typeIs(any) === 'RegExp';
+    /**
+     * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
+     * @param {string} str
+     * @return {Object | boolean}
+     */
+    function isJsonString(str) {
+        try {
+            const parsed = JSON.parse(str);
+            return typeof parsed === 'object' && parsed !== null ? parsed : false;
+        }
+        catch (e) {
+            return false;
+        }
+    }
 
     /**
      * 判断对象是否为纯对象
@@ -510,34 +524,24 @@
      */
     const stringFill = (length, value = ' ') => new Array(length).fill(value).join('');
     /**
-     * 字符串的像素宽度
-     * @param {string} str 目标字符串
-     * @param {number} fontSize 字符串字体大小
-     * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
-     * @returns {*}
+     * 解析URL查询参数
+     * @param {string} searchStr
+     * @return {Record<string, string | string[]>}
      */
-    function getStrWidthPx(str, fontSize = 14, isRemoveDom = false) {
-        let strWidth = 0;
-        console.assert(isString(str), `${str} 不是有效的字符串`);
-        if (isString(str) && str.length > 0) {
-            let getEle = document.querySelector('#getStrWidth1494304949567');
-            if (!getEle) {
-                const _ele = document.createElement('span');
-                _ele.id = 'getStrWidth1494304949567';
-                _ele.style.fontSize = fontSize + 'px';
-                _ele.style.whiteSpace = 'nowrap';
-                _ele.style.visibility = 'hidden';
-                _ele.textContent = str;
-                document.body.appendChild(_ele);
-                getEle = _ele;
+    function parseQueryParams(searchStr = location.search) {
+        const queryObj = {};
+        Array.from(searchStr.matchAll(/[&?]?([^=&]+)=?([^=&]*)/g)).forEach((item, i) => {
+            if (!queryObj[item[1]]) {
+                queryObj[item[1]] = item[2];
             }
-            getEle.textContent = str;
-            strWidth = getEle.offsetWidth;
-            if (isRemoveDom) {
-                document.body.appendChild(getEle);
+            else if (typeof queryObj[item[1]] === 'string') {
+                queryObj[item[1]] = [queryObj[item[1]], item[2]];
             }
-        }
-        return strWidth;
+            else {
+                queryObj[item[1]].push(item[2]);
+            }
+        });
+        return queryObj;
     }
 
     /**
@@ -682,6 +686,36 @@
         const originVal = getComputedStyle(el).getPropertyValue(property) ?? '';
         return reNumber ? Number(originVal.replace(/([0-9]*)(.*)/g, '$1')) : originVal;
     }
+    /**
+     * 字符串的像素宽度
+     * @param {string} str 目标字符串
+     * @param {number} fontSize 字符串字体大小
+     * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
+     * @returns {*}
+     */
+    function getStrWidthPx(str, fontSize = 14, isRemoveDom = false) {
+        let strWidth = 0;
+        console.assert(isString(str), `${str} 不是有效的字符串`);
+        if (isString(str) && str.length > 0) {
+            let getEle = document.querySelector('#getStrWidth1494304949567');
+            if (!getEle) {
+                const _ele = document.createElement('span');
+                _ele.id = 'getStrWidth1494304949567';
+                _ele.style.fontSize = fontSize + 'px';
+                _ele.style.whiteSpace = 'nowrap';
+                _ele.style.visibility = 'hidden';
+                _ele.textContent = str;
+                document.body.appendChild(_ele);
+                getEle = _ele;
+            }
+            getEle.textContent = str;
+            strWidth = getEle.offsetWidth;
+            if (isRemoveDom) {
+                document.body.appendChild(getEle);
+            }
+        }
+        return strWidth;
+    }
 
     const textEl = document.createElement('textarea');
     setStyle(textEl, {
@@ -1154,25 +1188,53 @@
      * 通过 A 链接的方式下载
      * @param {string} href
      * @param {string} filename
+     * @param {Function} callback
      */
-    function downloadHref(href, filename) {
+    function downloadHref(href, filename, callback) {
         const eleLink = document.createElement('a');
         eleLink.download = filename;
         eleLink.style.display = 'none';
         eleLink.href = href;
         document.body.appendChild(eleLink);
         eleLink.click();
-        setTimeout(() => document.body.removeChild(eleLink));
+        setTimeout(() => {
+            document.body.removeChild(eleLink);
+            if (isFunction(callback)) {
+                callback();
+            }
+        });
     }
     /**
      * 将大文件对象通过 A 链接的方式下载
      * @param {Blob} blob
      * @param {string} filename
+     * @param {Function} callback
      */
-    function downloadBlob(blob, filename) {
+    function downloadBlob(blob, filename, callback) {
         const objURL = URL.createObjectURL(blob);
         downloadHref(objURL, filename);
-        setTimeout(() => URL.revokeObjectURL(objURL));
+        setTimeout(() => {
+            URL.revokeObjectURL(objURL);
+            if (isFunction(callback)) {
+                callback();
+            }
+        });
+    }
+    /**
+     * 根据URL下载文件（解决跨域a.download不生效问题)
+     * @param {string} url
+     * @param {string} filename
+     * @param {Function} callback
+     */
+    function crossDomainDownload(url, filename, callback) {
+        const xhr = new XMLHttpRequest();
+        xhr.open('GET', url, true);
+        xhr.responseType = 'blob';
+        xhr.onload = function () {
+            if (xhr.status === 200)
+                downloadBlob(xhr.response, filename, callback);
+        };
+        xhr.send();
     }
     /**
      * 将指定数据格式通过 A 链接的方式下载
@@ -1315,49 +1377,49 @@
         }
         return result;
     }
-    function b64DecodeUnicode(str) {
-        return decodeURIComponent(exports.weAtob(str).replace(/(.)/g, function (p) {
-            let code = p.charCodeAt(0).toString(16).toUpperCase();
-            if (code.length < 2) {
-                code = '0' + code;
-            }
-            return '%' + code;
-        }));
-    }
-    function base64_url_decode(str) {
-        let output = str.replace(/-/g, '+').replace(/_/g, '/');
-        switch (output.length % 4) {
-            case 0:
-                break;
-            case 2:
-                output += '==';
-                break;
-            case 3:
-                output += '=';
-                break;
-            default:
-                throw new Error('Illegal base64url string!');
-        }
-        try {
-            return b64DecodeUnicode(output);
-        }
-        catch (err) {
-            return exports.weAtob(output);
-        }
-    }
-    function weAppJwtDecode(token, options) {
-        if (typeof token !== 'string') {
-            throw new Error('Invalid token specified');
-        }
-        options = options || {};
-        const pos = options.header === true ? 0 : 1;
-        try {
-            return JSON.parse(base64_url_decode(token.split('.')[pos]));
-        }
-        catch (e) {
-            throw new Error('Invalid token specified: ' + e.message);
-        }
-    }
+    // function b64DecodeUnicode(str) {
+    //   return decodeURIComponent(
+    //     exports.weAtob(str).replace(/(.)/g, function (p) {
+    //       let code = p.charCodeAt(0).toString(16).toUpperCase();
+    //       if (code.length < 2) {
+    //         code = '0' + code;
+    //       }
+    //       return '%' + code;
+    //     })
+    //   );
+    // }
+    // function base64_url_decode(str) {
+    //   let output = str.replace(/-/g, '+').replace(/_/g, '/');
+    //   switch (output.length % 4) {
+    //     case 0:
+    //       break;
+    //     case 2:
+    //       output += '==';
+    //       break;
+    //     case 3:
+    //       output += '=';
+    //       break;
+    //     default:
+    //       throw new Error('Illegal base64url string!');
+    //   }
+    //   try {
+    //     return b64DecodeUnicode(output);
+    //   } catch (err) {
+    //     return exports.weAtob(output);
+    //   }
+    // }
+    // export function weAppJwtDecode(token, options) {
+    //   if (typeof token !== 'string') {
+    //     throw new Error('Invalid token specified');
+    //   }
+    //   options = options || {};
+    //   const pos = options.header === true ? 0 : 1;
+    //   try {
+    //     return JSON.parse(base64_url_decode(token.split('.')[pos]));
+    //   } catch (e) {
+    //     throw new Error('Invalid token specified: ' + (e as Error).message);
+    //   }
+    // }
 
     /**
      * 判断是否支持canvas
@@ -2394,6 +2456,7 @@
     exports.cookieGet = cookieGet;
     exports.cookieSet = cookieSet;
     exports.copyText = copyText;
+    exports.crossDomainDownload = crossDomainDownload;
     exports.dateParse = dateParse;
     exports.dateToEnd = dateToEnd;
     exports.dateToStart = dateToStart;
@@ -2422,6 +2485,7 @@
     exports.isDomReady = isDomReady;
     exports.isError = isError;
     exports.isFunction = isFunction;
+    exports.isJsonString = isJsonString;
     exports.isNaN = isNaN;
     exports.isNull = isNull;
     exports.isNullOrUnDef = isNullOrUnDef;
@@ -2448,6 +2512,7 @@
     exports.objectPick = objectPick;
     exports.onDomReady = onDomReady;
     exports.once = once;
+    exports.parseQueryParams = parseQueryParams;
     exports.pathJoin = pathJoin;
     exports.pathNormalize = pathNormalize;
     exports.qsParse = qsParse;
@@ -2477,7 +2542,6 @@
     exports.urlSetParams = urlSetParams;
     exports.urlStringify = urlStringify;
     exports.wait = wait;
-    exports.weAppJwtDecode = weAppJwtDecode;
     exports.weAtob = weAtob;
     exports.weBtoa = weBtoa;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sculp-js",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "packageManager": "npm@8.19.2",
   "description": "js工具库",
   "scripts": {