youtil 1.0.8 → 1.0.10

package/cjs/index.d.ts

@@ -0,0 +1,105 @@
+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 | string, 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 | any): any;
+    /**
+     * HTML解码，例如将 【&quot;】 变成 【"】
+     * @param {*} html 已经被HTML编码过的字符串，如果传入对象会遍历处理
+     * @returns
+     */
+    decodeHtml(html: string | any): any;
+    /**
+     * 将一个普通对象转为 a=1&b=2 的URL格式，会自动过滤undefined的值
+     * @param data 一个普通对象，如果对象嵌对象则会被自动转为JSON
+     * @returns 返回类似 a=1&b=2 的字符串
+     */
+    toUrlParams(data: any): string;
+};
+export default _default;

package/cjs/index.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+var _instanceof = require("@swc/helpers/lib/_instanceof.js").default;
+var _slicedToArray = require("@swc/helpers/lib/_sliced_to_array.js").default;
+var _default = {
+    /**
+     * 将日期格式化成指定格式的字符串
+     * @param date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳等
+     * @param fmt 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+     * @returns 返回格式化后的日期字符串
+     */ formatDate: function formatDate(date, fmt) {
+        var _loop = 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(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);
+            });
+        };
+        if (!date) return "";
+        if (typeof date === "number") // 1687682453445
+        date = new Date(date);
+        else if (typeof date === "string") {
+            if (/^\d{12,13}$/g.test(date)) // '1687682453445'
+            date = new Date(parseInt(date));
+            else if (/^.{10}T.{8,12}Z?$/g.test(date)) // '2019-01-01T00:00:00.000Z'
+            date = new Date(date);
+            else return date;
+        }
+        if (!_instanceof(date, Date)) throw new Error("formatDate error: not date.");
+        if (isNaN(date === null || date === void 0 ? void 0 : date.getFullYear())) throw new Error("formatDate error: invalid date.");
+        fmt = fmt || "yyyy-MM-dd HH:mm:ss";
+        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()
+        };
+        var week = [
+            "天",
+            "一",
+            "二",
+            "三",
+            "四",
+            "五",
+            "六"
+        ];
+        // eslint-disable-next-line guard-for-in
+        for(var i in obj)_loop(i);
+        return fmt;
+    },
+    /**
+     * 将字符串解析成日期
+     * @param str 输入的日期字符串，如'2014-09-13'
+     * @param fmt 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S，不支持w和q
+     * @returns 解析后的Date类型日期
+     */ parseDate: function parseDate(str, fmt) {
+        fmt = fmt || "yyyy-MM-dd";
+        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("".concat($1, "(\\d{").concat($2.length, "})").concat($4)), function(_m, _$1) {
+                obj[$3] = parseInt(_$1);
+                return "";
+            });
+            return "";
+        });
+        obj.M--; // 月份是从0开始的，所以要减去1
+        var 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: function showLoading() {
+        var text = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : "请稍候", seconds = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 10, config = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
+        var _this = this;
+        var defaultConfig = {
+            hasMask: true,
+            maskColor: "transparent",
+            onCancel: null,
+            cancelInline: false,
+            id: "com_global_page_loading"
+        };
+        config = Object.assign({}, defaultConfig, config);
+        var id = config.id;
+        var timeoutKey = "_".concat(id, "_timeout");
+        if (window[timeoutKey]) clearTimeout(window[timeoutKey]);
+        var dom = document.getElementById(id);
+        if (!dom) {
+            dom = document.createElement("div");
+            dom.id = id;
+            dom.className = id;
+            document.body.append(dom);
+        }
+        var styleId = "".concat(id, "_style");
+        if (!document.getElementById(styleId)) {
+            var style = document.createElement("style");
+            style.id = styleId;
+            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 = "\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="https://img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">\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) {
+            var btn = dom.querySelector(".cancel");
+            btn && btn.addEventListener("click", function() {
+                _this.hideLoading();
+                config.onCancel();
+            });
+        }
+        dom.style.display = "block";
+        if (seconds > 0) window[timeoutKey] = setTimeout(function() {
+            _this.hideLoading();
+        }, seconds * 1000);
+    },
+    // 隐藏全局loading
+    hideLoading: function hideLoading() {
+        var id = "com_global_page_loading";
+        var 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: function getParam(name) {
+        var url = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : location.search;
+        return (new RegExp("(^|\\?|&)".concat(name, "=(.*?)(?=&|#|$)"), "g").exec(url) || [])[2];
+    },
+    /**
+     * 从URL中获取int参数
+     * @param {*} name 参数名
+     * @param {*} url 要获取的URL，默认当前地址
+     */ getParamInt: function getParamInt(name) {
+        var url = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 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: function getParams() {
+        var url = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : location.search;
+        var search = ((url || "").split("?").pop() || "").split("#")[0] || "";
+        var params = {};
+        search.split("&").map(function(item) {
+            return item.split("=");
+        }).forEach(function(param) {
+            var _param = _slicedToArray(param, 2), key = _param[0], value = _param[1];
+            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: function setParam(name, value, url) {
+        url = url || "".concat(location.pathname).concat(location.search);
+        // 如果参数已经存在，替换之
+        if (this.getParam(name, url) !== undefined) return url.replace(new RegExp("(^|\\?|&)".concat(name, "=(.*?)(?=&|#|$)"), "g"), "$1".concat(name, "=").concat(value));
+        var _url_split = _slicedToArray(url.split("#"), 2), pathname = _url_split[0], hash = _url_split[1]; // 处理存在hash的情况
+        return "".concat(pathname).concat(pathname.indexOf("?") < 0 ? "?" : "&").concat(name, "=").concat(value).concat(hash ? "#" : "").concat(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: function delParam(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毫秒
+     * @param time 要休息的时间，单位毫秒，不传默认0
+     * @returns 
+     */ sleep: function(time) {
+        return new Promise(function(resolve) {
+            return setTimeout(resolve, time || 0);
+        });
+    },
+    /**
+     * 基于JSON的简单深拷贝
+     * @param obj 要复制的对象，非对象格式会直接返回
+     * @returns 
+     */ deepCopy: function(obj) {
+        if (!obj || typeof obj !== "object") return obj;
+        return JSON.parse(JSON.stringify(obj));
+    },
+    /**
+     * HTML编码，例如将 【"】 变成 【&quot;】
+     * @param {*} html 待编码的原始字符串，如果传入对象会遍历处理
+     * @returns 
+     */ encodeHtml: function encodeHtml(html) {
+        if (typeof html === "string") {
+            var div = document.createElement("div");
+            div.innerText = html;
+            return div.innerHTML;
+        } else if (typeof html === "object" && html) for(var i in html)html[i] = this.encodeHtml(html[i]);
+        return html;
+    },
+    /**
+     * HTML解码，例如将 【&quot;】 变成 【"】
+     * @param {*} html 已经被HTML编码过的字符串，如果传入对象会遍历处理
+     * @returns 
+     */ decodeHtml: function decodeHtml(html) {
+        if (typeof html === "string") {
+            var div = document.createElement("div");
+            div.innerHTML = html;
+            return div.innerText;
+        } else if (typeof html === "object" && html) for(var i in html)html[i] = this.decodeHtml(html[i]);
+        return html;
+    },
+    /**
+     * 将一个普通对象转为 a=1&b=2 的URL格式，会自动过滤undefined的值
+     * @param data 一个普通对象，如果对象嵌对象则会被自动转为JSON
+     * @returns 返回类似 a=1&b=2 的字符串
+     */ toUrlParams: function toUrlParams(data) {
+        return Object.keys(data || {}).filter(function(key) {
+            return data[key] !== undefined;
+        }).map(function(key) {
+            var value = typeof data[key] === "object" ? JSON.stringify(data[key]) : data[key];
+            return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        }).join("&");
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "youtil",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "油梯，一个与框架、环境无关的小巧、精简、实用的JavaScript工具库",
   "files": [
     "esm",
@@ -42,13 +42,12 @@
     "youtil"
   ],
   "dependencies": {
-    "@ice/pkg-plugin-docusaurus": "^1.4.18",
-    "@swc/helpers": "^0.4.14"
+    "@swc/helpers": "0.4.14"
   },
   "devDependencies": {
     "@ice/jsx-runtime": "^0.2.0",
-    "@ice/pkg": "^1.5.5",
-    "@ice/pkg-plugin-docusaurus": "^1.4.10",
+    "@ice/pkg": "1.5.5",
+    "@ice/pkg-plugin-docusaurus": "^1.4.18",
     "@iceworks/spec": "^1.0.0",
     "eslint": "^7.0.0",
     "jest": "^29.5.0",