@ajaxjs/util 1.1.3 → 1.2.1

package/dist/index.esm.js

@@ -1,51 +1,115 @@
+function getQueryParam(variable, isParent = false) {
+    const query = (isParent ? parent.location : window.location).search.substring(1);
+    const vars = query.split("&");
+    for (let i = 0; i < vars.length; i++) {
+        const pair = vars[i].split("=");
+        if (pair[0] == variable)
+            return pair[1];
+    }
+    return null;
+}
 /**
- * 获取某个 Cookie
+ * 函数节流
  *
- * @param name 键名称
- * @returns 值
+ * @author https://www.cnblogs.com/moqiutao/p/6875955.html
+ * @param fn
+ * @param delay
+ * @param mustRunDelay
  */
-function getCookie(name) {
-    let arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
-    // @ts-ignore
-    if (arr = document.cookie.match(reg))
-        return unescape(arr[2]);
-    else
-        return null;
+function throttle(fn, delay, mustRunDelay) {
+    let timer, t_start;
+    return function () {
+        let t_curr = +new Date();
+        window.clearTimeout(timer);
+        if (!t_start)
+            t_start = t_curr;
+        if (t_curr - t_start >= mustRunDelay) {
+            fn.apply(this, arguments);
+            t_start = t_curr;
+        }
+        else {
+            let args = arguments;
+            timer = window.setTimeout(() => fn.apply(this, args), delay);
+        }
+    };
 }
 /**
- * 设置某个 Cookie
+ * 并行和串行任务
  *
- * @param name  键名称
- * @param value 值
+ * @author https://segmentfault.com/a/1190000013265925
+ * @param arr
+ * @param finnaly
  */
-function setCookie(name, value) {
-    let days = 2, exp = new Date();
-    exp.setTime(exp.getTime() + days * 24 * 60 * 60 * 1000);
+function parallel(arr, _finally) {
+    let fn, index = 0;
     // @ts-ignore
-    document.cookie = name + "=" + escape(value) + ";path=/;expires=" + exp.toGMTString();
+    let statusArr = Array(arr.length).fill().map(() => ({ isActive: false, data: null }));
+    let isFinished = () => statusArr.every((item) => item.isActive === true);
+    let resolve = function (index) {
+        return function (data) {
+            statusArr[index].data = data;
+            statusArr[index].isActive = true;
+            let isFinish = isFinished();
+            if (isFinish) {
+                let datas = statusArr.map((item) => item.data);
+                _finally(datas);
+            }
+        };
+    };
+    while ((fn = arr.shift())) {
+        fn(resolve(index)); // 给 resolve 函数追加参数,可以使用 bind 函数实现,这里使用了柯里化
+        index++;
+    }
 }
 /**
- * 清空 Cookie
+ * 通用的打开下载对话框方法，没有测试过具体兼容性
+ * https://www.cnblogs.com/liuxianan/p/js-download.html
+ *
+ * ref 这应该是你见过的最全前端下载总结 https://juejin.cn/post/6844903763359039501
+ *
+ * @param url 下载地址，也可以是一个blob对象，必选
+ * @param saveName 保存文件名，可选
  */
-function delCookie() {
-    let keys = document.cookie.match(/[^ =;]+(?==)/g);
-    if (keys) {
-        let date = new Date(0).toUTCString();
-        for (let i = keys.length; i--;) {
-            document.cookie = keys[i] + '=0;path=/;expires=' + date; // 清除当前域名下的,例如：m.ratingdog.cn
-            document.cookie = keys[i] + '=0;path=/;domain=' + document.domain + ';expires=' + date; // 清除当前域名下的，例如 .m.ratingdog.cn
-            document.cookie = keys[i] + '=0;path=/;domain=' + location.host + ';expires=' + date; // 清除一级域名下的或指定的，例如 .ratingdog.cn
+function openDownloadDialog(url, saveName) {
+    if (typeof url == 'object' && url instanceof Blob)
+        url = URL.createObjectURL(url); // 创建blob地址
+    const aLink = document.createElement('a');
+    aLink.href = url;
+    aLink.download = saveName || ''; // HTML5新增的属性，指定保存文件名，可以不要后缀，注意，file:///模式下不会生效
+    let event;
+    if (window.MouseEvent)
+        event = new MouseEvent('click');
+    else {
+        event = document.createEvent('MouseEvents');
+        event.initMouseEvent('click', true, false, window, 0, 0, 0, 0, 0, false, false, false, false, 0, null);
+    }
+    aLink.dispatchEvent(event);
+}
+function myHTMLInclude() {
+    let a, file, xhttp;
+    const z = document.getElementsByTagName("*");
+    for (let i = 0; i < z.length; i++) {
+        if (z[i].getAttribute("w3-include-html")) {
+            a = z[i].cloneNode(false);
+            file = z[i].getAttribute("w3-include-html");
+            xhttp = new XMLHttpRequest();
+            xhttp.onreadystatechange = function () {
+                if (xhttp.readyState == 4 && xhttp.status == 200) {
+                    a.removeAttribute("w3-include-html");
+                    a.innerHTML = xhttp.responseText;
+                    // @ts-ignore
+                    z[i].parentNode.replaceChild(a, z[i]);
+                    myHTMLInclude();
+                }
+            };
+            if (file) {
+                xhttp.open("GET", file, false);
+                xhttp.send();
+            }
+            return;
         }
     }
 }
-
-var cookies = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    delCookie: delCookie,
-    getCookie: getCookie,
-    setCookie: setCookie
-});
-
 /**
  * 向父级元素递归搜索
  *
@@ -68,56 +132,48 @@ function up(_el, tagName, className) {
     }
     return null;
 }
-/**
- * 加载脚本
- *
- * @param url   脚本地址
- * @param id    脚本元素 id，可选的
- * @param cb    回调函数，可选的
- */
-function loadScript(url, id, cb) {
-    let script = document.createElement("script");
-    script.src = url;
-    if (cb)
-        script.onload = cb;
-    if (id)
-        script.id = id;
-    document.getElementsByTagName("head")[0].appendChild(script);
-}
 
-var dom = /*#__PURE__*/Object.freeze({
+var utils = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    loadScript: loadScript,
+    getQueryParam: getQueryParam,
+    myHTMLInclude: myHTMLInclude,
+    openDownloadDialog: openDownloadDialog,
+    parallel: parallel,
+    throttle: throttle,
     up: up
 });
 
 /**
- * 通用工具类
- */
-/**
- * 是否调试模式中
+ * 格式化日期时间
  *
- * 打包成组件之后不能用
+ * @param {string} format 日期格式化模板
+ * @returns {string} 格式化后的日期字符串
+ * @this {Date} 调用此方法的Date对象
+ * @example
+ * // 返回类似 "2023-12-25 14:30:00"
+ * new Date().format("yyyy-MM-dd hh:mm:ss");
+ * // 返回类似 "23-12-25"
+ * new Date().format("yy-MM-dd");
+ * // 返回类似 "2023年12月25日"
+ * new Date().format("yyyy年MM月dd日");
  *
- * @returns
+ * 格式化模板说明：
+ * - yyyy: 四位年份
+ * - yy: 两位年份
+ * - MM: 两位月份（01-12）
+ * - M: 一位月份（1-12）
+ * - dd: 两位日期（01-31）
+ * - d: 一位日期（1-31）
+ * - hh: 两位小时（00-23）
+ * - h: 一位小时（0-23）
+ * - mm: 两位分钟（00-59）
+ * - m: 一位分钟（0-59）
+ * - ss: 两位秒钟（00-59）
+ * - s: 一位秒钟（0-59）
+ * - q: 季度（1-4）
+ * - S: 毫秒（000-999）
  */
-function isDebug() {
-    // @ts-ignore
-    return process.env.NODE_ENV === 'development';
-}
-function isDev() {
-    let currentHostname = window.location.hostname;
-    // 判断主机名是否是内网地址
-    return (currentHostname.startsWith('192.168.') || currentHostname.startsWith('10.') || currentHostname === 'localhost');
-}
-/**
-* 日期格式化。详见博客文章：http://blog.csdn.net/zhangxin09/archive/2011/01/01/6111294.aspx
-* e.g: new Date().format("yyyy-MM-dd hh:mm:ss")
-*
-* @param 	{String} format
-* @return	{String}
-*/
-function dateFormat(format) {
+function formatDate(format) {
     let $1, o = {
         "M+": this.getMonth() + 1, // 月份，从0开始算
         "d+": this.getDate(), // 日期
@@ -128,13 +184,15 @@ function dateFormat(format) {
         "q+": Math.floor((this.getMonth() + 3) / 3),
         "S": this.getMilliseconds() // 千秒
     };
-    if (/(y+)/.test(format))
-        // @ts-ignore
-        $1 = RegExp.$1, format = format.replace($1, String(this.getFullYear()).substr(4 - $1));
     let key, value;
+    if (/(y+)/.test(format)) {
+        $1 = RegExp.$1,
+            format = format.replace($1, String(this.getFullYear()).substr(4 - $1));
+    }
     for (key in o) { // 如果没有指定该参数，则子字符串将延续到 stringvar 的最后。
         if (new RegExp("(" + key + ")").test(format)) {
             $1 = RegExp.$1,
+                // @ts-ignore
                 value = String(o[key]),
                 value = $1.length == 1 ? value : ("00" + value).substr(value.length),
                 format = format.replace($1, value);
@@ -144,382 +202,102 @@ function dateFormat(format) {
 }
 /**
  * 日期格式化
- * @author meizz
- * @param date  日期，必须为 Date 类型
- * @param fmt   格式模板
- * @returns 格式化后的字符串
- */
-function dateFormat2(date, fmt) {
-    let o = {
-        "M+": date.getMonth() + 1, // 月份   
-        "d+": date.getDate(), // 日   
-        "h+": date.getHours(), // 小时   
-        "m+": date.getMinutes(), // 分   
-        "s+": date.getSeconds(), // 秒   
-        "q+": Math.floor((date.getMonth() + 3) / 3), // 季度   
-        "S": date.getMilliseconds() // 毫秒   
-    };
-    if (/(y+)/.test(fmt))
-        fmt = fmt.replace(RegExp.$1, (date.getFullYear() + "").substr(4 - RegExp.$1.length));
-    for (var k in o)
-        if (new RegExp("(" + k + ")").test(fmt)) {
-            let obj = (RegExp.$1.length == 1) ? o[k] : ("00" + o[k]).substr(("" + o[k]).length);
-            // @ts-ignore
-            fmt = fmt.replace(RegExp.$1, obj);
-        }
-    return fmt;
-}
-/**
- * 并行和串行任务
  *
- * @author https://segmentfault.com/a/1190000013265925
- * @param arr
- * @param finnaly
+ * @param {date}
+ * @param {string} format 日期格式化模板
+ * @returns {string} 格式化后的日期字符串
  */
-function parallel(arr, _finally) {
-    let fn, index = 0;
-    // @ts-ignore
-    let statusArr = Array(arr.length).fill().map(() => ({ isActive: false, data: null }));
-    let isFinished = function () {
-        return statusArr.every((item) => item.isActive === true);
-    };
-    let resolve = function (index) {
-        return function (data) {
-            statusArr[index].data = data;
-            statusArr[index].isActive = true;
-            let isFinish = isFinished();
-            if (isFinish) {
-                let datas = statusArr.map((item) => item.data);
-                _finally(datas);
-            }
-        };
-    };
-    // @ts-ignore
-    while ((fn = arr.shift())) {
-        fn(resolve(index)); // 给 resolve 函数追加参数,可以使用 bind 函数实现,这里使用了柯里化
-        index++;
-    }
-}
-/**
- * 函数节流
- *
- * @author https://www.cnblogs.com/moqiutao/p/6875955.html
- * @param fn
- * @param delay
- * @param mustRunDelay
- */
-function throttle(fn, delay, mustRunDelay) {
-    var timer, t_start;
-    return function () {
-        var t_curr = +new Date();
-        window.clearTimeout(timer);
-        if (!t_start)
-            t_start = t_curr;
-        if (t_curr - t_start >= mustRunDelay) {
-            // @ts-ignore
-            fn.apply(this, arguments);
-            t_start = t_curr;
-        }
-        else {
-            var args = arguments;
-            // @ts-ignore
-            timer = window.setTimeout(() => fn.apply(this, args), delay);
-        }
-    };
+function dateFormat(date, format) {
+    return formatDate.call(new Date(date), format);
 }
-/**
-* 复制文字到剪切板
-*
-* @param {string} text
-*/
-function copyToClipboard(text) {
-    if (navigator.clipboard)
-        navigator.clipboard.writeText(text); // clipboard api 复制
-    else {
-        let textarea = document.createElement('textarea');
-        document.body.appendChild(textarea); // 隐藏此输入框
-        textarea.style.position = 'fixed';
-        textarea.style.clip = 'rect(0 0 0 0)';
-        textarea.style.top = '10px';
-        textarea.value = text; // 赋值
-        textarea.select(); // 选中
-        document.execCommand('copy', true); // 复制
-        document.body.removeChild(textarea); // 移除输入框
-    }
+function now(format = 'yyyy-MM-dd hh:mm') {
+    return formatDate.call(new Date(), format);
 }
 
-var utils = /*#__PURE__*/Object.freeze({
+var date_format = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    copyToClipboard: copyToClipboard,
     dateFormat: dateFormat,
-    dateFormat2: dateFormat2,
-    isDebug: isDebug,
-    isDev: isDev,
-    parallel: parallel,
-    throttle: throttle
+    now: now
 });
 
-/**
- * 默认的请求配置
- */
-const DEFAULT_XHR_CFG = {
-    timeout: 5000,
-    withCredentials: false,
-    parseContentType: 'json'
-};
-/**
- * 全局请求的 head 参数
- */
-let BASE_HEAD_PARAMS = null;
-/**
- * 设置全局请求的 head 参数
- *
- * @param param
- */
-function setBaseHeadParams(params) {
-    if (BASE_HEAD_PARAMS === null)
-        BASE_HEAD_PARAMS = {};
-    Object.assign(BASE_HEAD_PARAMS, params);
-}
-/**
- *
- * @param getOrDel
- * @param url
- * @param cb
- * @param params
- * @param cfg
- */
-function getOrDel(getOrDel, url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    let xhr = initXhr(cfg);
-    if (params != null) {
-        if (url.indexOf('?') != -1)
-            url += '&' + toParams(params);
-        else
-            url += '?' + toParams(params);
+function request(api, method, bodyData, callback, header) {
+    let headers = {};
+    if (header)
+        for (const key in header)
+            headers[key] = header[key];
+    method = method.toUpperCase();
+    let body = bodyData;
+    if (bodyData && (method === 'POST' || method === 'PUT')) {
+        if (headers['Content-Type'] == 'application/json')
+            body = JSON.stringify(bodyData);
+        else if (headers['Content-Type'] == "application/x-www-form-urlencoded")
+            body = json2formParams(bodyData);
     }
-    xhr.open(getOrDel.toUpperCase(), url, true);
-    xhr.onreadystatechange = function () {
-        responseHandle(this, cb, cfg);
-    };
-    if (BASE_HEAD_PARAMS) // 设置自定义请求头
-        for (let key in BASE_HEAD_PARAMS)
-            xhr.setRequestHeader(key, BASE_HEAD_PARAMS[key]);
-    xhr.send();
-}
-/**
- *
- * @param method
- * @param url
- * @param cb
- * @param params
- * @param cfg
- */
-function postOrPut(method, url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    let xhr = initXhr(cfg);
-    xhr.open(method, url, true);
-    xhr.onreadystatechange = function () {
-        responseHandle(this, cb, cfg);
-    };
-    if (BASE_HEAD_PARAMS) // 设置自定义请求头
-        for (let key in BASE_HEAD_PARAMS)
-            xhr.setRequestHeader(key, BASE_HEAD_PARAMS[key]);
-    // 此方法必须在 open() 方法和 send() 之间调用
-    if (!cfg.contentType) // 如未设置，默认为表单请求
-        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
-    else
-        xhr.setRequestHeader("Content-Type", cfg.contentType);
-    let _params = typeof params != 'string' ? toParams(params) : params;
-    if (_params)
-        xhr.send(_params);
-    else
-        xhr.send();
-}
-/**
- *
- * @param url
- * @param cb
- * @param params
- * @param cfg
- */
-function xhr_post_upload(url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    let xhr = initXhr(cfg);
-    xhr.open('post', url, true);
-    xhr.onreadystatechange = function () {
-        responseHandle(this, cb, cfg);
-    };
-    if (BASE_HEAD_PARAMS) // 设置自定义请求头
-        for (let key in BASE_HEAD_PARAMS)
-            xhr.setRequestHeader(key, BASE_HEAD_PARAMS[key]);
-    // 什么 Content-Type 都不设置
-    xhr.send(params);
-}
-/**
- * XHR GET 请求
- *
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型是json；参数值会进行 URL 编码，最后附加到 QueryString 中
- * @param cfg       配置，可选的
- */
-function xhr_get(url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    getOrDel('get', url, cb, params, cfg);
-}
-/**
- * XHR DELETE 请求
- *
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型是json；参数值会进行 URL 编码，最后附加到 QueryString 中
- * @param cfg       配置，可选的
- */
-function xhr_del(url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    getOrDel('delete', url, cb, params, cfg);
-}
-/**
- * XHR POST 请求
- *
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型可以是字符串或 json；参数值会进行 URL 编码
- * @param cfg       配置，可选的
- */
-function xhr_post(url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    postOrPut('post', url, cb, params, cfg);
-}
-/**
- * XHR PUT 请求
- *
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型可以是字符串或 json；参数值会进行 URL 编码
- * @param cfg       配置，可选的
- */
-function xhr_put(url, cb, params, cfg = DEFAULT_XHR_CFG) {
-    postOrPut('put', url, cb, params, cfg);
+    fetch(api, {
+        method,
+        headers: headers,
+        body,
+        credentials: 'include'
+    }).then(response => {
+        if (response.status === 404)
+            throw new Error('Not found 404: ' + api);
+        else if (response.status === 500)
+            throw new Error('Server error: ' + api);
+        else if (!response.ok)
+            throw new Error(`Unexpected status: ${response.status}`);
+        return response.json();
+    })
+        .then(data => {
+        if (callback)
+            callback(data); // 调用回调
+    })
+        .catch(error => {
+        console.error('Network error when fetching from: ' + api, error); // 网络错误时才会 reject Promise
+    });
 }
-/**
- * 初始化 XHR
- *
- * @param cfg
- * @returns
- */
-function initXhr(cfg) {
-    let xhr = new XMLHttpRequest();
-    if (cfg && cfg.timeout) {
-        xhr.timeout = cfg.timeout;
-        xhr.ontimeout = (e) => console.error('系统异常，XHR 连接服务超时');
+function json2formParams(params) {
+    const pairs = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== null && value !== undefined && typeof value !== 'function')
+            pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
     }
-    if (cfg && cfg.withCredentials)
-        xhr.withCredentials = true;
-    return xhr;
+    return pairs.join('&');
 }
 /**
- * 错误处理
+ * HTTP GET 请求
  *
- * @param xhr
+ * @param api API 地址
+ * @param callback
+ * @param header
  */
-function errHandle(xhr) {
-    let msg;
-    if (xhr.status <= 400)
-        msg = '请求参数错误或者权限不足。';
-    else if (xhr.status <= 500)
-        msg = '服务端异常。';
-    else
-        msg = `未知异常，HTTP code:${xhr.status}。`;
-    if (!xhr.responseText)
-        msg += " 服务端返回空的字符串！";
-    console.error(msg, xhr.responseText);
+function get(api, callback, header) {
+    request(api, 'GET', null, callback, header);
 }
-/**
- * 响应处理
- *
- * @param xhr
- * @param cb
- * @param cfg
- */
-function responseHandle(xhr, cb, cfg) {
-    if (xhr.readyState == 4) {
-        if ((xhr.status >= 200 && xhr.status < 300) || xhr.status == 304) {
-            let text = xhr.responseText;
-            let json;
-            if (!text)
-                console.warn('服务端没有返回任何字符串');
-            switch (cfg.parseContentType) {
-                case 'text':
-                    break;
-                case 'xml':
-                    json = xhr.responseXML;
-                    break;
-                case 'json':
-                default:
-                    try {
-                        json = JSON.parse(text);
-                    }
-                    catch (e) {
-                        console.error('解析 JSON 时候发生错误，非法 JSON');
-                        console.warn(e);
-                    }
-            }
-            cb && cb(json, text);
-        }
-        else
-            errHandle(xhr);
-    }
+function post(api, bodyData, callback, header) {
+    request(api, 'POST', bodyData, callback, Object.assign({ 'Content-Type': 'application/json' }, header));
 }
-/**
- * 对象转换为 URL 参数列表，用 & 分隔
- *
- * @param {Object} param JSON 对象
- * @returns URL 参数列表
- */
-function toParams(param) {
-    let result = "";
-    for (let name in param) {
-        if (typeof param[name] != "function")
-            result += "&" + name + "=" + encodeURIComponent(param[name]);
-    }
-    return result.substring(1);
+function postForm(api, bodyData, callback, header) {
+    request(api, 'POST', bodyData, callback, Object.assign({ 'Content-Type': 'application/x-www-form-urlencoded' }, header));
 }
-/**
- * 获取 QueryString 的某个参数
- *
- * @param val
- * @returns
-*/
-function getQuery(val) {
-    const w = location.hash.indexOf('?');
-    const query = location.hash.substring(w + 1);
-    let vars = query.split('&');
-    for (let i = 0; i < vars.length; i++) {
-        const pair = vars[i].split('=');
-        if (pair[0] == val)
-            return pair[1];
-    }
-    return '';
+function put(api, bodyData, callback, header) {
+    request(api, 'PUT', bodyData, callback, Object.assign({ 'Content-Type': 'application/json' }, header));
 }
-function getPageList(self, listArray, callback) {
-    return (j) => {
-        if (j.status) {
-            listArray.total = j.total;
-            listArray.data = j.data;
-            callback && callback();
-        }
-        else
-            self.$Message.warning(j.message || '获取数据失败');
-    };
+function putForm(api, bodyData, callback, header) {
+    request(api, 'PUT', bodyData, callback, Object.assign({ 'Content-Type': 'application/x-www-form-urlencoded' }, header));
+}
+function del(api, callback, header) {
+    request(api, 'DELETE', null, callback, header);
 }
 
-var xhr = /*#__PURE__*/Object.freeze({
+var xhr_fetch = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    getPageList: getPageList,
-    getQuery: getQuery,
-    setBaseHeadParams: setBaseHeadParams,
-    toParams: toParams,
-    xhr_del: xhr_del,
-    xhr_get: xhr_get,
-    xhr_post: xhr_post,
-    xhr_post_upload: xhr_post_upload,
-    xhr_put: xhr_put
+    del: del,
+    get: get,
+    post: post,
+    postForm: postForm,
+    put: put,
+    putForm: putForm
 });
 
-export { cookies as Cookies, dom as Dom, utils as Utils, xhr as Xhr };
+export { date_format as DateFormat, utils as Utils, xhr_fetch as Xhr, xhr_fetch as XhrFetch };
+//# sourceMappingURL=index.esm.js.map