youtil 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,3 +1,15 @@
-# 1.0.0 (2022-11-14)
+# CHANGELOG
+
+## 1.0.2 (2023-02-09)
+
+* 增加`encodeHtml`、`decodeHtml`、`deepCopy`方法；
+
+## 1.0.1 (2023-02-09)
+
+* js改ts；
+* `main`修改为`dist/index.js`；
+* 增加简单的单侧；
+
+## 1.0.0 (2022-11-14)
 
 * 初始化第一个版本；

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 小茗同学
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,3 @@
-# feutil
+# youtil
 
-存放与框架（Vue、React等）、环境（Nodejs、Web等）无关的通用方法工具库。
+油梯，一个与框架（Vue、React等）、环境（Nodejs、Web等）无关的小巧、精简、实用的JavaScript工具库

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+interface IShowLoadingConfig {
+    hasMask?: boolean;
+    maskColor?: string;
+    cancelInline?: boolean;
+    onCancel?: Function;
+    id?: string;
+}
+declare const _default: {
+    /**
+     * 将日期格式化成指定格式的字符串
+     * @param date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳
+     * @param fmt 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+     * @returns 返回格式化后的日期字符串
+     */
+    formatDate(date?: Date | number, fmt?: string): string;
+    /**
+     * 将字符串解析成日期
+     * @param str 输入的日期字符串，如'2014-09-13'
+     * @param fmt 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S，不支持w和q
+     * @returns 解析后的Date类型日期
+     */
+    parseDate(str: string, fmt?: string): Date;
+    /**
+     * 显示全局loading
+     * @param {*} text
+     * @param {*} seconds
+     * @param {*} options
+     */
+    showLoading(text?: string, seconds?: number, config?: IShowLoadingConfig): void;
+    hideLoading(): void;
+    /**
+     * 从URL中获取某个参数，如果不存在返回 undefined ，如果存在多个同名参数，返回第一个匹配值
+     * getParam('a', '?a=1&b=&c=3&c=33#abc') // '1'
+     * getParam('b', '?a=1&b=&c=3&c=33#abc') // ''
+     * getParam('c', '?a=1&b=&c=3&c=33#abc') // 3
+     * getParam('d', '?a=1&b=&c=3&c=33#abc') // undefined
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */
+    getParam(name: string, url?: string): string;
+    /**
+     * 从URL中获取int参数
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */
+    getParamInt(name: string, url?: string): number;
+    /**
+     * 获取某个URL的全部参数
+     * getParams('?a=1&b=2#cc') // {a: '1', b: '2'}
+     * @param url
+     * @returns 参数对象
+     */
+    getParams(url?: string): any;
+    /**
+     * 给URL设置参数，如果已经存在，替换之，兼容hash存在的情况
+     * setParam('a', '123', '?a=1&b=2&a=3#d') // '?a=123&b=2&a=123#d'
+     * setParam('d', '444', '?a=1&b=2&a=3#d') // '?a=1&b=2&a=3&d=444#d'
+     * @param {Object} name 参数名
+     * @param {Object} value 参数值
+     * @param {Object} url 如果不传默认当前页面URL
+     */
+    setParam(name: string, value: string | number, url?: string): string;
+    /**
+     * 删除URL中某个参数
+     * delParam('a', '?a=1&b=2&a=3#d') // '?b=2#d'
+     * delParam('b', '?a=1&b=2&a=3#d') // '?a=1&a=3#d'
+     * delParam('a', '?a=1#d') // '#d'
+     * @param name 参数名
+     * @param url 要删除的URL，默认当前页面URL
+     * @returns 处理完后的URL
+     */
+    delParam(name: string, url: string): string;
+    /**
+     * 休息一段时间，单位毫秒
+     * 示例：await sleep(200); // 休息200毫秒
+     * @param time 要休息的时间，单位毫秒，不传默认0
+     * @returns
+     */
+    sleep: (time?: number) => Promise<unknown>;
+    /**
+     * 基于JSON的简单深拷贝
+     * @param obj 要复制的对象，非对象格式会直接返回
+     * @returns
+     */
+    deepCopy: (obj: any) => any;
+    /**
+     * HTML编码，例如将 【"】 变成 【&quot;】
+     * @param {*} html 待编码的原始字符串
+     * @returns
+     */
+    encodeHtml(html: string): string;
+    /**
+     * HTML解码，例如将 【&quot;】 变成 【"】
+     * @param {*} html 已经被HTML编码过的字符串
+     * @returns
+     */
+    decodeHtml(html: string): string;
+};
+export default _default;

package/dist/index.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    /**
+     * 将日期格式化成指定格式的字符串
+     * @param date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳
+     * @param fmt 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+     * @returns 返回格式化后的日期字符串
+     */
+    formatDate(date, fmt) {
+        if (!date) {
+            return '';
+        }
+        date = typeof date === 'number' ? new Date(date) : date;
+        fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
+        const obj = {
+            y: date.getFullYear(),
+            M: date.getMonth() + 1,
+            d: date.getDate(),
+            q: Math.floor((date.getMonth() + 3) / 3),
+            w: date.getDay(),
+            H: date.getHours(),
+            h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12,
+            m: date.getMinutes(),
+            s: date.getSeconds(),
+            S: date.getMilliseconds(), // 毫秒
+        };
+        const week = ['天', '一', '二', '三', '四', '五', '六'];
+        // eslint-disable-next-line guard-for-in
+        for (const i in obj) {
+            fmt = fmt.replace(new RegExp(`${i}+`, 'g'), function (m) {
+                let val = `${obj[i]}`;
+                if (i === 'w') {
+                    return (m.length > 2 ? '星期' : '周') + week[val];
+                }
+                for (let j = 0, len = val.length; j < m.length - len; j++) {
+                    val = `0${val}`;
+                }
+                return m.length === 1 ? val : val.substring(val.length - m.length);
+            });
+        }
+        return fmt;
+    },
+    /**
+     * 将字符串解析成日期
+     * @param str 输入的日期字符串，如'2014-09-13'
+     * @param fmt 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S，不支持w和q
+     * @returns 解析后的Date类型日期
+     */
+    parseDate(str, fmt) {
+        fmt = fmt || 'yyyy-MM-dd';
+        const obj = { y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0 };
+        fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function (m, $1, $2, $3, $4) {
+            str = str.replace(new RegExp(`${$1}(\\d{${$2.length}})${$4}`), function (_m, _$1) {
+                obj[$3] = parseInt(_$1);
+                return '';
+            });
+            return '';
+        });
+        obj.M--; // 月份是从0开始的，所以要减去1
+        const date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
+        if (obj.S !== 0) {
+            date.setMilliseconds(obj.S); // 如果设置了毫秒
+        }
+        return date;
+    },
+    /**
+     * 显示全局loading
+     * @param {*} text
+     * @param {*} seconds
+     * @param {*} options
+     */
+    showLoading(text = '请稍候', seconds = 10, config = {}) {
+        const defaultConfig = {
+            hasMask: true,
+            maskColor: 'transparent',
+            onCancel: null,
+            cancelInline: false,
+            id: 'com_global_page_loading',
+        };
+        config = Object.assign({}, defaultConfig, config);
+        const { id } = config;
+        const timeoutKey = `_${id}_timeout`;
+        if (window[timeoutKey]) {
+            clearTimeout(window[timeoutKey]);
+        }
+        let dom = document.getElementById(id);
+        if (!dom) {
+            dom = document.createElement('div');
+            dom.id = id;
+            dom.className = id;
+            document.body.append(dom);
+        }
+        const styleId = `${id}_style`;
+        if (!document.getElementById(styleId)) {
+            const style = document.createElement('style');
+            style.id = styleId;
+            style.innerHTML = `
+            .${id} {
+                position: fixed;
+                top: calc(50vh - 60px);
+                left: calc(50vw - 60px);
+                width: 120px;
+                height: 120px;
+                z-index: 8000;
+                background: rgba(0, 0, 0, 0.6);
+                border-radius: 8px;
+                text-align: center;
+                color: white;
+                padding-top: 20px;
+            }
+            .${id} img {
+                width: 50px;
+                margin-bottom: 10px;
+            }`;
+            document.head.appendChild(style);
+        }
+        dom.innerHTML = `
+            ${config.hasMask ? `<div class="mask-wrapper" style="background-color: ${config.maskColor}"></div>` : ''}
+            <div class="loading-wrapper">
+                <div class="loading-content">
+                    <img src="//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
+                    <div>${text}${config.cancelInline ? ' ' : '</div>'}
+                    ${config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : ''}
+                    ${config.cancelInline ? '</div>' : ''}
+                </div>
+            </div>`;
+        if (config.onCancel) {
+            const btn = dom.querySelector('.cancel');
+            btn && btn.addEventListener('click', () => {
+                this.hideLoading();
+                config.onCancel();
+            });
+        }
+        dom.style.display = 'block';
+        if (seconds > 0) {
+            window[timeoutKey] = setTimeout(() => {
+                this.hideLoading();
+            }, seconds * 1000);
+        }
+    },
+    // 隐藏全局loading
+    hideLoading() {
+        const id = 'com_global_page_loading';
+        const loading = document.getElementById(id);
+        if (loading) {
+            loading.style.display = 'none';
+        }
+    },
+    /**
+     * 从URL中获取某个参数，如果不存在返回 undefined ，如果存在多个同名参数，返回第一个匹配值
+     * getParam('a', '?a=1&b=&c=3&c=33#abc') // '1'
+     * getParam('b', '?a=1&b=&c=3&c=33#abc') // ''
+     * getParam('c', '?a=1&b=&c=3&c=33#abc') // 3
+     * getParam('d', '?a=1&b=&c=3&c=33#abc') // undefined
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */
+    getParam(name, url = location.search) {
+        return (new RegExp(`(^|\\?|&)${name}=(.*?)(?=&|#|$)`, 'g').exec(url) || [])[2];
+    },
+    /**
+     * 从URL中获取int参数
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */
+    getParamInt(name, url = location.search) {
+        return parseInt(this.getParam(name, url) || '0', 10);
+    },
+    /**
+     * 获取某个URL的全部参数
+     * getParams('?a=1&b=2#cc') // {a: '1', b: '2'}
+     * @param url
+     * @returns 参数对象
+     */
+    getParams(url = location.search) {
+        const search = ((url || '').split('?').pop() || '').split('#')[0] || '';
+        const params = {};
+        search.split('&').map(item => item.split('=')).forEach(([key, value]) => {
+            params[key] = value || '';
+        });
+        return params;
+    },
+    /**
+     * 给URL设置参数，如果已经存在，替换之，兼容hash存在的情况
+     * setParam('a', '123', '?a=1&b=2&a=3#d') // '?a=123&b=2&a=123#d'
+     * setParam('d', '444', '?a=1&b=2&a=3#d') // '?a=1&b=2&a=3&d=444#d'
+     * @param {Object} name 参数名
+     * @param {Object} value 参数值
+     * @param {Object} url 如果不传默认当前页面URL
+     */
+    setParam(name, value, url) {
+        url = url || `${location.pathname}${location.search}`;
+        // 如果参数已经存在，替换之
+        if (this.getParam(name, url) !== undefined) {
+            return url.replace(new RegExp(`(^|\\?|&)${name}=(.*?)(?=&|#|$)`, 'g'), `$1${name}=${value}`);
+        }
+        const [pathname, hash] = url.split('#'); // 处理存在hash的情况
+        return `${pathname}${pathname.indexOf('?') < 0 ? '?' : '&'}${name}=${value}${hash ? '#' : ''}${hash || ''}`;
+    },
+    /**
+     * 删除URL中某个参数
+     * delParam('a', '?a=1&b=2&a=3#d') // '?b=2#d'
+     * delParam('b', '?a=1&b=2&a=3#d') // '?a=1&a=3#d'
+     * delParam('a', '?a=1#d') // '#d'
+     * @param name 参数名
+     * @param url 要删除的URL，默认当前页面URL
+     * @returns 处理完后的URL
+     */
+    delParam(name, url) {
+        url = url || `${location.pathname}${location.search}`;
+        return url.replace(new RegExp(`(^|\\?|&)${name}=.*?(&|#|$)`, 'g'), (_m, $1, $2) => $2 === '&' ? $1 : $2);
+    },
+    /**
+     * 休息一段时间，单位毫秒
+     * 示例：await sleep(200); // 休息200毫秒
+     * @param time 要休息的时间，单位毫秒，不传默认0
+     * @returns
+     */
+    sleep: (time) => new Promise(resolve => setTimeout(resolve, time || 0)),
+    /**
+     * 基于JSON的简单深拷贝
+     * @param obj 要复制的对象，非对象格式会直接返回
+     * @returns
+     */
+    deepCopy: (obj) => {
+        if (!obj || typeof obj !== 'object') {
+            return obj;
+        }
+        return JSON.parse(JSON.stringify(obj));
+    },
+    /**
+     * HTML编码，例如将 【"】 变成 【&quot;】
+     * @param {*} html 待编码的原始字符串
+     * @returns
+     */
+    encodeHtml(html) {
+        const div = document.createElement('div');
+        div.innerText = html;
+        return div.innerHTML;
+    },
+    /**
+     * HTML解码，例如将 【&quot;】 变成 【"】
+     * @param {*} html 已经被HTML编码过的字符串
+     * @returns
+     */
+    decodeHtml(html) {
+        const div = document.createElement('div');
+        div.innerHTML = html;
+        return div.innerText;
+    },
+};

package/package.json

@@ -1,20 +1,25 @@
 {
   "name": "youtil",
-  "version": "1.0.0",
-  "description": "Front-ent util",
-  "main": "src/index.js",
+  "version": "1.0.2",
+  "description": "油梯，一个与框架、环境无关的小巧、精简、实用的JavaScript工具库",
+  "main": "dist/index.js",
   "dependencies": {},
-  "devDependencies": {},
+  "devDependencies": {
+    "jest": "^29.4.2",
+    "typescript": "^4.9.5"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "jest",
+    "build": "tsc -d",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
     "url": "github.com/sxei/youtil"
   },
   "keywords": [
-    "feutil"
+    "youtil"
   ],
   "author": "sxei",
-  "license": "ISC"
-}
+  "license": "MIT"
+}

package/src/index.js

@@ -1,41 +1,46 @@
-export default {
+"use strict";
+exports.__esModule = true;
+exports["default"] = {
     /**
      * 将日期格式化成指定格式的字符串
      * @param date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳
      * @param fmt 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
      * @returns 返回格式化后的日期字符串
      */
-    formatDate(date, fmt) {
+    formatDate: function (date, fmt) {
         if (!date) {
             return '';
         }
         date = typeof date === 'number' ? new Date(date) : date;
         fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
-        const obj = {
-            y: date.getFullYear(), // 年份，注意必须用getFullYear
-            M: date.getMonth() + 1, // 月份，注意是从0-11
-            d: date.getDate(), // 日期
-            q: Math.floor((date.getMonth() + 3) / 3), // 季度
-            w: date.getDay(), // 星期，注意是0-6
-            H: date.getHours(), // 24小时制
-            h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12, // 12小时制
-            m: date.getMinutes(), // 分钟
-            s: date.getSeconds(), // 秒
-            S: date.getMilliseconds(), // 毫秒
+        var obj = {
+            y: date.getFullYear(),
+            M: date.getMonth() + 1,
+            d: date.getDate(),
+            q: Math.floor((date.getMonth() + 3) / 3),
+            w: date.getDay(),
+            H: date.getHours(),
+            h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12,
+            m: date.getMinutes(),
+            s: date.getSeconds(),
+            S: date.getMilliseconds()
         };
-        const week = ['天', '一', '二', '三', '四', '五', '六'];
-        // eslint-disable-next-line guard-for-in
-        for (const i in obj) {
-            fmt = fmt.replace(new RegExp(`${i}+`, 'g'), function (m) {
-                let val = `${obj[i]}`;
+        var week = ['天', '一', '二', '三', '四', '五', '六'];
+        var _loop_1 = function (i) {
+            fmt = fmt.replace(new RegExp("".concat(i, "+"), 'g'), function (m) {
+                var val = "".concat(obj[i]);
                 if (i === 'w') {
                     return (m.length > 2 ? '星期' : '周') + week[val];
                 }
-                for (let j = 0, len = val.length; j < m.length - len; j++) {
-                    val = `0${val}`;
+                for (var j = 0, len = val.length; j < m.length - len; j++) {
+                    val = "0".concat(val);
                 }
                 return m.length === 1 ? val : val.substring(val.length - m.length);
             });
+        };
+        // eslint-disable-next-line guard-for-in
+        for (var i in obj) {
+            _loop_1(i);
         }
         return fmt;
     },
@@ -45,18 +50,18 @@ export default {
      * @param fmt 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S，不支持w和q
      * @returns 解析后的Date类型日期
      */
-    parseDate(str, fmt) {
+    parseDate: function (str, fmt) {
         fmt = fmt || 'yyyy-MM-dd';
-        const obj = { y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0 };
+        var obj = { y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0 };
         fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function (m, $1, $2, $3, $4) {
-            str = str.replace(new RegExp(`${$1}(\\d{${$2.length}})${$4}`), function (_m, _$1) {
+            str = str.replace(new RegExp("".concat($1, "(\\d{").concat($2.length, "})").concat($4)), function (_m, _$1) {
                 obj[$3] = parseInt(_$1);
                 return '';
             });
             return '';
         });
         obj.M--; // 月份是从0开始的，所以要减去1
-        const date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
+        var date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
         if (obj.S !== 0) {
             date.setMilliseconds(obj.S); // 如果设置了毫秒
         }
@@ -68,79 +73,57 @@ export default {
      * @param {*} seconds
      * @param {*} options
      */
-    showLoading(text = '请稍候', seconds = 10, config = {}) {
-        const defaultConfig = {
+    showLoading: function (text, seconds, config) {
+        var _this = this;
+        if (text === void 0) { text = '请稍候'; }
+        if (seconds === void 0) { seconds = 10; }
+        if (config === void 0) { config = {}; }
+        var defaultConfig = {
             hasMask: true,
             maskColor: 'transparent',
             onCancel: null,
             cancelInline: false,
-            id: 'com_global_page_loading',
+            id: 'com_global_page_loading'
         };
         config = Object.assign({}, defaultConfig, config);
-        const { id } = config;
-        const timeoutKey = `_${id}_timeout`;
+        var id = config.id;
+        var timeoutKey = "_".concat(id, "_timeout");
         if (window[timeoutKey]) {
             clearTimeout(window[timeoutKey]);
         }
-        let dom = document.getElementById(id);
+        var dom = document.getElementById(id);
         if (!dom) {
             dom = document.createElement('div');
             dom.id = id;
             dom.className = id;
             document.body.append(dom);
         }
-        const styleId = `${id}_style`;
+        var styleId = "".concat(id, "_style");
         if (!document.getElementById(styleId)) {
-            const style = document.createElement('style');
+            var style = document.createElement('style');
             style.id = styleId;
-            style.innerHTML = `
-            .${id} {
-                position: fixed;
-                top: calc(50vh - 60px);
-                left: calc(50vw - 60px);
-                width: 120px;
-                height: 120px;
-                z-index: 8000;
-                background: rgba(0, 0, 0, 0.6);
-                border-radius: 8px;
-                text-align: center;
-                color: white;
-                padding-top: 20px;
-            }
-            .${id} img {
-                width: 50px;
-                margin-bottom: 10px;
-            }`;
+            style.innerHTML = "\n            .".concat(id, " {\n                position: fixed;\n                top: calc(50vh - 60px);\n                left: calc(50vw - 60px);\n                width: 120px;\n                height: 120px;\n                z-index: 8000;\n                background: rgba(0, 0, 0, 0.6);\n                border-radius: 8px;\n                text-align: center;\n                color: white;\n                padding-top: 20px;\n            }\n            .").concat(id, " img {\n                width: 50px;\n                margin-bottom: 10px;\n            }");
             document.head.appendChild(style);
         }
-        dom.innerHTML = `
-            ${config.hasMask ? `<div class="mask-wrapper" style="background-color: ${config.maskColor}"></div>` : ''}
-            <div class="loading-wrapper">
-                <div class="loading-content">
-                    <img src="//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
-                    <div>${text}${config.cancelInline ? ' ' : '</div>'}
-                    ${config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : ''}
-                    ${config.cancelInline ? '</div>' : ''}
-                </div>
-            </div>`;
+        dom.innerHTML = "\n            ".concat(config.hasMask ? "<div class=\"mask-wrapper\" style=\"background-color: ".concat(config.maskColor, "\"></div>") : '', "\n            <div class=\"loading-wrapper\">\n                <div class=\"loading-content\">\n                    <img src=\"//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg\" alt=\"\u52A0\u8F7D\u4E2D\">\n                    <div>").concat(text).concat(config.cancelInline ? ' ' : '</div>', "\n                    ").concat(config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : '', "\n                    ").concat(config.cancelInline ? '</div>' : '', "\n                </div>\n            </div>");
         if (config.onCancel) {
-            const btn = dom.querySelector('.cancel');
-            btn && btn.addEventListener('click', () => {
-                this.hideLoading();
+            var btn = dom.querySelector('.cancel');
+            btn && btn.addEventListener('click', function () {
+                _this.hideLoading();
                 config.onCancel();
             });
         }
         dom.style.display = 'block';
         if (seconds > 0) {
-            window[timeoutKey] = setTimeout(() => {
-                this.hideLoading();
+            window[timeoutKey] = setTimeout(function () {
+                _this.hideLoading();
             }, seconds * 1000);
         }
     },
     // 隐藏全局loading
-    hideLoading() {
-        const id = 'com_global_page_loading';
-        const loading = document.getElementById(id);
+    hideLoading: function () {
+        var id = 'com_global_page_loading';
+        var loading = document.getElementById(id);
         if (loading) {
             loading.style.display = 'none';
         }
@@ -154,27 +137,31 @@ export default {
      * @param {*} name 参数名
      * @param {*} url 要获取的URL，默认当前地址
      */
-    getParam(name, url = location.search) {
-        return (new RegExp(`(^|\\?|&)${name}=(.*?)(?=&|#|$)`, 'g').exec(url) || [])[2];
+    getParam: function (name, url) {
+        if (url === void 0) { url = location.search; }
+        return (new RegExp("(^|\\?|&)".concat(name, "=(.*?)(?=&|#|$)"), 'g').exec(url) || [])[2];
     },
     /**
      * 从URL中获取int参数
      * @param {*} name 参数名
      * @param {*} url 要获取的URL，默认当前地址
      */
-    getParamInt(name, url = location.search) {
+    getParamInt: function (name, url) {
+        if (url === void 0) { url = location.search; }
         return parseInt(this.getParam(name, url) || '0', 10);
     },
     /**
      * 获取某个URL的全部参数
      * getParams('?a=1&b=2#cc') // {a: '1', b: '2'}
-     * @param url 
+     * @param url
      * @returns 参数对象
      */
-    getParams(url = location.search) {
-        const search = ((url || '').split('?').pop() || '').split('#')[0] || '';
-        const params = {};
-        search.split('&').map(item => item.split('=')).forEach(([key, value]) => {
+    getParams: function (url) {
+        if (url === void 0) { url = location.search; }
+        var search = ((url || '').split('?').pop() || '').split('#')[0] || '';
+        var params = {};
+        search.split('&').map(function (item) { return item.split('='); }).forEach(function (_a) {
+            var key = _a[0], value = _a[1];
             params[key] = value || '';
         });
         return params;
@@ -187,14 +174,14 @@ export default {
      * @param {Object} value 参数值
      * @param {Object} url 如果不传默认当前页面URL
      */
-    setParam(name, value, url) {
-        url = url || `${location.pathname}${location.search}`;
+    setParam: function (name, value, url) {
+        url = url || "".concat(location.pathname).concat(location.search);
         // 如果参数已经存在，替换之
         if (this.getParam(name, url) !== undefined) {
-            return url.replace(new RegExp(`(^|\\?|&)${name}=(.*?)(?=&|#|$)`, 'g'), `$1${name}=${value}`);
+            return url.replace(new RegExp("(^|\\?|&)".concat(name, "=(.*?)(?=&|#|$)"), 'g'), "$1".concat(name, "=").concat(value));
         }
-        const [pathname, hash] = url.split('#'); // 处理存在hash的情况
-        return `${pathname}${pathname.indexOf('?') < 0 ? '?' : '&'}${name}=${value}${hash ? '#' : ''}${hash || ''}`;
+        var _a = url.split('#'), pathname = _a[0], hash = _a[1]; // 处理存在hash的情况
+        return "".concat(pathname).concat(pathname.indexOf('?') < 0 ? '?' : '&').concat(name, "=").concat(value).concat(hash ? '#' : '').concat(hash || '');
     },
     /**
      * 删除URL中某个参数
@@ -205,13 +192,15 @@ export default {
      * @param url 要删除的URL，默认当前页面URL
      * @returns 处理完后的URL
      */
-    delParam(name, url) {
-        url = url || `${location.pathname}${location.search}`;
-        return url.replace(new RegExp(`(^|\\?|&)${name}=.*?(&|#|$)`, 'g'), (_m, $1, $2) => $2 === '&' ? $1 : $2);
+    delParam: function (name, url) {
+        url = url || "".concat(location.pathname).concat(location.search);
+        return url.replace(new RegExp("(^|\\?|&)".concat(name, "=.*?(&|#|$)"), 'g'), function (_m, $1, $2) { return $2 === '&' ? $1 : $2; });
     },
     /**
-     * 延迟一段时间，单位毫秒
-     * await sleep(200) // 休息200毫秒
+     * 休息一段时间，单位毫秒
+     * 示例：await sleep(200); // 休息200毫秒
+     * @param time 要休息的时间，单位毫秒，不传默认0
+     * @returns
      */
-    sleep: (sec) => new Promise(resolve => setTimeout(resolve, sec)),
+    sleep: function (time) { return new Promise(function (resolve) { return setTimeout(resolve, time || 0); }); }
 };

package/src/index.ts

@@ -0,0 +1,257 @@
+interface IShowLoadingConfig {
+    hasMask?: boolean;
+    maskColor?: string;
+    cancelInline?: boolean;
+    onCancel?: Function;
+    id?: string,
+}
+export default {
+    /**
+     * 将日期格式化成指定格式的字符串
+     * @param date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳
+     * @param fmt 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+     * @returns 返回格式化后的日期字符串
+     */
+    formatDate(date?: Date | number, fmt?: string) {
+        if (!date) {
+            return '';
+        }
+        date = typeof date === 'number' ? new Date(date) : date;
+        fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
+        const obj: any = {
+            y: date.getFullYear(), // 年份，注意必须用getFullYear
+            M: date.getMonth() + 1, // 月份，注意是从0-11
+            d: date.getDate(), // 日期
+            q: Math.floor((date.getMonth() + 3) / 3), // 季度
+            w: date.getDay(), // 星期，注意是0-6
+            H: date.getHours(), // 24小时制
+            h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12, // 12小时制
+            m: date.getMinutes(), // 分钟
+            s: date.getSeconds(), // 秒
+            S: date.getMilliseconds(), // 毫秒
+        };
+        const week: any = ['天', '一', '二', '三', '四', '五', '六'];
+        // eslint-disable-next-line guard-for-in
+        for (const i in obj) {
+            fmt = fmt.replace(new RegExp(`${i}+`, 'g'), function (m) {
+                let val = `${obj[i]}`;
+                if (i === 'w') {
+                    return (m.length > 2 ? '星期' : '周') + week[val];
+                }
+                for (let j = 0, len = val.length; j < m.length - len; j++) {
+                    val = `0${val}`;
+                }
+                return m.length === 1 ? val : val.substring(val.length - m.length);
+            });
+        }
+        return fmt;
+    },
+    /**
+     * 将字符串解析成日期
+     * @param str 输入的日期字符串，如'2014-09-13'
+     * @param fmt 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S，不支持w和q
+     * @returns 解析后的Date类型日期
+     */
+    parseDate(str: string, fmt?: string) {
+        fmt = fmt || 'yyyy-MM-dd';
+        const obj: any = { y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0 };
+        fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function (m, $1, $2, $3, $4) {
+            str = str.replace(new RegExp(`${$1}(\\d{${$2.length}})${$4}`), function (_m, _$1) {
+                obj[$3] = parseInt(_$1);
+                return '';
+            });
+            return '';
+        });
+        obj.M--; // 月份是从0开始的，所以要减去1
+        const date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
+        if (obj.S !== 0) {
+            date.setMilliseconds(obj.S); // 如果设置了毫秒
+        }
+        return date;
+    },
+    /**
+     * 显示全局loading
+     * @param {*} text
+     * @param {*} seconds
+     * @param {*} options
+     */
+    showLoading(text = '请稍候', seconds = 10, config: IShowLoadingConfig = {}) {
+        const defaultConfig: IShowLoadingConfig = {
+            hasMask: true,
+            maskColor: 'transparent',
+            onCancel: null,
+            cancelInline: false,
+            id: 'com_global_page_loading',
+        };
+        config = Object.assign({}, defaultConfig, config);
+        const { id } = config;
+        const timeoutKey = `_${id}_timeout`;
+        if ((window as any)[timeoutKey]) {
+            clearTimeout((window as any)[timeoutKey]);
+        }
+        let dom = document.getElementById(id);
+        if (!dom) {
+            dom = document.createElement('div');
+            dom.id = id;
+            dom.className = id;
+            document.body.append(dom);
+        }
+        const styleId = `${id}_style`;
+        if (!document.getElementById(styleId)) {
+            const style = document.createElement('style');
+            style.id = styleId;
+            style.innerHTML = `
+            .${id} {
+                position: fixed;
+                top: calc(50vh - 60px);
+                left: calc(50vw - 60px);
+                width: 120px;
+                height: 120px;
+                z-index: 8000;
+                background: rgba(0, 0, 0, 0.6);
+                border-radius: 8px;
+                text-align: center;
+                color: white;
+                padding-top: 20px;
+            }
+            .${id} img {
+                width: 50px;
+                margin-bottom: 10px;
+            }`;
+            document.head.appendChild(style);
+        }
+        dom.innerHTML = `
+            ${config.hasMask ? `<div class="mask-wrapper" style="background-color: ${config.maskColor}"></div>` : ''}
+            <div class="loading-wrapper">
+                <div class="loading-content">
+                    <img src="//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
+                    <div>${text}${config.cancelInline ? ' ' : '</div>'}
+                    ${config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : ''}
+                    ${config.cancelInline ? '</div>' : ''}
+                </div>
+            </div>`;
+        if (config.onCancel) {
+            const btn = dom.querySelector('.cancel');
+            btn && btn.addEventListener('click', () => {
+                this.hideLoading();
+                config.onCancel();
+            });
+        }
+        dom.style.display = 'block';
+        if (seconds > 0) {
+            (window as any)[timeoutKey] = setTimeout(() => {
+                this.hideLoading();
+            }, seconds * 1000);
+        }
+    },
+    // 隐藏全局loading
+    hideLoading() {
+        const id = 'com_global_page_loading';
+        const loading = document.getElementById(id);
+        if (loading) {
+            loading.style.display = 'none';
+        }
+    },
+    /**
+     * 从URL中获取某个参数，如果不存在返回 undefined ，如果存在多个同名参数，返回第一个匹配值
+     * getParam('a', '?a=1&b=&c=3&c=33#abc') // '1'
+     * getParam('b', '?a=1&b=&c=3&c=33#abc') // ''
+     * getParam('c', '?a=1&b=&c=3&c=33#abc') // 3
+     * getParam('d', '?a=1&b=&c=3&c=33#abc') // undefined
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */
+    getParam(name: string, url: string = location.search) {
+        return (new RegExp(`(^|\\?|&)${name}=(.*?)(?=&|#|$)`, 'g').exec(url) || [])[2];
+    },
+    /**
+     * 从URL中获取int参数
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */
+    getParamInt(name: string, url: string = location.search) {
+        return parseInt(this.getParam(name, url) || '0', 10);
+    },
+    /**
+     * 获取某个URL的全部参数
+     * getParams('?a=1&b=2#cc') // {a: '1', b: '2'}
+     * @param url 
+     * @returns 参数对象
+     */
+    getParams(url = location.search) {
+        const search = ((url || '').split('?').pop() || '').split('#')[0] || '';
+        const params: any = {};
+        search.split('&').map(item => item.split('=')).forEach(([key, value]) => {
+            params[key] = value || '';
+        });
+        return params;
+    },
+    /**
+     * 给URL设置参数，如果已经存在，替换之，兼容hash存在的情况
+     * setParam('a', '123', '?a=1&b=2&a=3#d') // '?a=123&b=2&a=123#d'
+     * setParam('d', '444', '?a=1&b=2&a=3#d') // '?a=1&b=2&a=3&d=444#d'
+     * @param {Object} name 参数名
+     * @param {Object} value 参数值
+     * @param {Object} url 如果不传默认当前页面URL
+     */
+    setParam(name: string, value: string | number, url?: string) {
+        url = url || `${location.pathname}${location.search}`;
+        // 如果参数已经存在，替换之
+        if (this.getParam(name, url) !== undefined) {
+            return url.replace(new RegExp(`(^|\\?|&)${name}=(.*?)(?=&|#|$)`, 'g'), `$1${name}=${value}`);
+        }
+        const [pathname, hash] = url.split('#'); // 处理存在hash的情况
+        return `${pathname}${pathname.indexOf('?') < 0 ? '?' : '&'}${name}=${value}${hash ? '#' : ''}${hash || ''}`;
+    },
+    /**
+     * 删除URL中某个参数
+     * delParam('a', '?a=1&b=2&a=3#d') // '?b=2#d'
+     * delParam('b', '?a=1&b=2&a=3#d') // '?a=1&a=3#d'
+     * delParam('a', '?a=1#d') // '#d'
+     * @param name 参数名
+     * @param url 要删除的URL，默认当前页面URL
+     * @returns 处理完后的URL
+     */
+    delParam(name: string, url: string) {
+        url = url || `${location.pathname}${location.search}`;
+        return url.replace(new RegExp(`(^|\\?|&)${name}=.*?(&|#|$)`, 'g'), (_m, $1, $2) => $2 === '&' ? $1 : $2);
+    },
+    /**
+     * 休息一段时间，单位毫秒
+     * 示例：await sleep(200); // 休息200毫秒
+     * @param time 要休息的时间，单位毫秒，不传默认0
+     * @returns 
+     */
+    sleep: (time?: number) => new Promise(resolve => setTimeout(resolve, time || 0)),
+    /**
+     * 基于JSON的简单深拷贝
+     * @param obj 要复制的对象，非对象格式会直接返回
+     * @returns 
+     */
+    deepCopy: (obj: any) => {
+        if (!obj || typeof obj !== 'object') {
+            return obj;
+        }
+        return JSON.parse(JSON.stringify(obj));
+    },
+    /**
+     * HTML编码，例如将 【"】 变成 【&quot;】
+     * @param {*} html 待编码的原始字符串
+     * @returns 
+     */
+    encodeHtml(html: string) {
+        const div = document.createElement('div');
+        div.innerText = html;
+        return div.innerHTML;
+    },
+    /**
+     * HTML解码，例如将 【&quot;】 变成 【"】
+     * @param {*} html 已经被HTML编码过的字符串
+     * @returns 
+     */
+    decodeHtml(html: string) {
+        const div = document.createElement('div');
+        div.innerHTML = html;
+        return div.innerText;
+    },
+};

package/test/index.test.js

@@ -0,0 +1,14 @@
+const youtil = require('../dist');
+const { formatDate, getParam } = youtil.default;
+
+test('formatDate', () => {
+    expect(formatDate(1675935902379)).toBe('2023-02-09 17:45:02');
+    expect(formatDate(1675935902379, 'yyyy-MM-dd')).toBe('2023-02-09');
+});
+
+test('getParam', () => {
+    expect(getParam('a', '?a=1&b=&c=3&c=33#abc')).toBe('1');
+    expect(getParam('b', '?a=1&b=&c=3&c=33#abc')).toBe('');
+    expect(getParam('c', '?a=1&b=&c=3&c=33#abc')).toBe('3');
+    expect(getParam('d', '?a=1&b=&c=3&c=33#abc')).toBe(undefined);
+});

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "es2015",
+    "rootDir": "src",
+    "outDir": "dist",
+    "module": "CommonJS",
+    "noImplicitAny": true,
+    "skipLibCheck": true,
+  }
+}