@ajaxjs/util 1.1.1 → 1.1.2

package/README.md

@@ -1,17 +1,66 @@
 [![NPM](https://img.shields.io/npm/v/@ajaxjs/util.svg?sanitize=true)](https://www.npmjs.com/package/@ajaxjs/util)
-[![Vue.js](https://img.shields.io/badge/Vue.js-2.6.14-brightgreen.svg?style=flat&logo=vuedotjs&logoColor=white)](https://vuejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-4.9.4-blue.svg?style=flat&logo=Typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-Apache--2.0-green.svg?longCache=true&style=flat)](http://www.apache.org/licenses/LICENSE-2.0.txt)
 [![Email](https://img.shields.io/badge/Contact--me-Email-orange.svg)](mailto:frank@ajaxjs.com)
 [![QQ群](https://framework.ajaxjs.com/static/qq.svg)](https://shang.qq.com/wpa/qunwpa?idkey=3877893a4ed3a5f0be01e809e7ac120e346102bd550deb6692239bb42de38e22)
 
+# AjaxJS JS Utils
+Some common JS functions.
 
-# JS Utils & a Simple Widget Library 
+NPM: https://www.npmjs.com/package/@ajaxjs/util
 
-A few widgets, vue.js + typescript + less.js
 
-NPM: https://www.npmjs.com/package/@ajaxjs/util
+# How to create a NPM package?
+Use Rollup to build your package.
+
+```
+npm init
+npm add typescript -D
+tsc --init
+
+npm install rollup -g        # 全局安装
+npm install rollup -D        # 项目本地安装
+npm install @rollup/plugin-typescript -D  # 将Typescript转换成为 ES6+ 标准
+npm install @rollup/plugin-commonjs -D    # rollup默认不支持CommonJS，自己写的时候可以尽量避免使用CommonJS模块的语法，但有些外部库的是cjs或者umd（由webpack打包的）。如果使用这些外部库就需要支持CommonJS模块。
+npm install @rollup/plugin-node-resolve -D
+npm init @eslint/config
+npm install -D eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin
+```
+
+https://chieminchan.vercel.app/articles/Project%20Management/%E6%89%8B%E6%8A%8A%E6%89%8B%E6%95%99%E4%BD%A0%E5%8F%91%E4%B8%AAnpm%E5%8C%85.html
+
+# Rollup Config
+## 1
+
+升级到最新版本 rollup: 4.14.3 后 rollup.config.js 配置文件中却不能使用 es6 import 语法了！
+
+    rollup: 4.14.3 时报错：SyntaxError: Cannot use import statement outside a module
+
+解决方法1
+打包命令添加： `--bundleConfigAsCjs`
+修改打包命令： `"dev": "rollup -c rollup.config.js --bundleConfigAsCjs -w"` 重新执行则解决
+
+
+解决方法2
+package.json 中添加："type": "module",
+这样设置只是支持 es6语法，但 import 语法是不可以引入 .json文件的！
+
+
+链接：https://juejin.cn/post/7359893210797015051
+
+## 2
+项目至少包含一个扩展名为 `.ts` 的文件
+
+    error TS18003: No inputs were found in config file '/Users/jiyik/workspace/ts/tsconfig.json'. Specified 'include' paths were '["src/**/*"]' and 'exclude' paths were '["node_modules"]'
 
-## Install
+`tsconfig.json` 文件中设置：
 
-    npm i @ajaxjs/util
+```json
+{
+  "compilerOptions": {
+    // ... 配置项
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}
+```

package/dist/index.esm.js

@@ -0,0 +1,525 @@
+/**
+ * 获取某个 Cookie
+ *
+ * @param name 键名称
+ * @returns 值
+ */
+function getCookie(name) {
+    let arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
+    // @ts-ignore
+    if (arr = document.cookie.match(reg))
+        return unescape(arr[2]);
+    else
+        return null;
+}
+/**
+ * 设置某个 Cookie
+ *
+ * @param name  键名称
+ * @param value 值
+ */
+function setCookie(name, value) {
+    let days = 2, exp = new Date();
+    exp.setTime(exp.getTime() + days * 24 * 60 * 60 * 1000);
+    // @ts-ignore
+    document.cookie = name + "=" + escape(value) + ";path=/;expires=" + exp.toGMTString();
+}
+/**
+ * 清空 Cookie
+ */
+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
+        }
+    }
+}
+
+var cookies = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    delCookie: delCookie,
+    getCookie: getCookie,
+    setCookie: setCookie
+});
+
+/**
+ * 向父级元素递归搜索
+ *
+ * @param _el       当前所在元素
+ * @param tagName   目标标签名称
+ * @param className 目标元素样式类
+ * @returns 目标元素，找不到为 null
+ */
+function up(_el, tagName, className) {
+    if (tagName && className)
+        throw '只能任选一种参数，不能同时传';
+    let el = _el.parentNode;
+    tagName = tagName && tagName.toUpperCase();
+    while (el) {
+        if (tagName && el.tagName == tagName)
+            return el;
+        if (className && el.className && ~el.className.indexOf(className))
+            return el;
+        el = el.parentNode;
+    }
+    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({
+    __proto__: null,
+    loadScript: loadScript,
+    up: up
+});
+
+/**
+ * 通用工具类
+ */
+/**
+ * 是否调试模式中
+ *
+ * 打包成组件之后不能用
+ *
+ * @returns
+ */
+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) {
+    let $1, o = {
+        "M+": this.getMonth() + 1, // 月份，从0开始算
+        "d+": this.getDate(), // 日期
+        "h+": this.getHours(), // 小时
+        "m+": this.getMinutes(), // 分钟
+        "s+": this.getSeconds(), // 秒钟
+        // 季度 quarter
+        "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;
+    for (key in o) { // 如果没有指定该参数，则子字符串将延续到 stringvar 的最后。
+        if (new RegExp("(" + key + ")").test(format)) {
+            $1 = RegExp.$1,
+                value = String(o[key]),
+                value = $1.length == 1 ? value : ("00" + value).substr(value.length),
+                format = format.replace($1, value);
+        }
+    }
+    return 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
+ */
+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);
+        }
+    };
+}
+/**
+* 复制文字到剪切板
+*
+* @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); // 移除输入框
+    }
+}
+
+var utils = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    copyToClipboard: copyToClipboard,
+    dateFormat: dateFormat,
+    dateFormat2: dateFormat2,
+    isDebug: isDebug,
+    isDev: isDev,
+    parallel: parallel,
+    throttle: throttle
+});
+
+/**
+ * 默认的请求配置
+ */
+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);
+    }
+    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);
+}
+/**
+ * 初始化 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 连接服务超时');
+    }
+    if (cfg && cfg.withCredentials)
+        xhr.withCredentials = true;
+    return xhr;
+}
+/**
+ * 错误处理
+ *
+ * @param xhr
+ */
+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);
+}
+/**
+ * 响应处理
+ *
+ * @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);
+    }
+}
+/**
+ * 对象转换为 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);
+}
+/**
+ * 获取 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 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 || '获取数据失败');
+    };
+}
+
+var xhr = /*#__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
+});
+
+export { cookies as Cookies, dom as Dom, utils as Utils, xhr as Xhr };