@ajaxjs/util 1.1.2 → 1.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajaxjs/util",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Core JS Utils",
   "scripts": {
     "dev": "rollup -w -c",
@@ -8,15 +8,17 @@
   },
   "main": "dist/index.umd.js",
   "module": "dist/index.esm.js",
-  "types": "dist/index.d.ts",
+  "types": "dist/src/index.d.ts",
   "type": "module",
   "files": [
-    "src/",
     "dist/"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/lightweight-component/js"
+    "url": "https://github.com/lightweight-component/js/tree/main/util"
+  },
+  "bugs": {
+    "url": "https://github.com/lightweight-component/js/issues"
   },
   "keywords": [
     "ajaxjs",

package/src/core/cookies.ts

@@ -1,43 +0,0 @@
-/**
- * 获取某个 Cookie
- * 
- * @param name 键名称 
- * @returns 值
- */
-export function getCookie(name: string): string | null {
-    let arr: RegExpMatchArray, reg: RegExp = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
-    // @ts-ignore
-    if (arr = document.cookie.match(reg))
-        return unescape(arr[2]);
-    else
-        return null;
-}
-
-/**
- * 设置某个 Cookie
- * 
- * @param name  键名称 
- * @param value 值
- */
-export function setCookie(name: string, value: string): void {
-    let days: number = 2, exp: Date = new Date();
-    exp.setTime(exp.getTime() + days * 24 * 60 * 60 * 1000);
-    // @ts-ignore
-    document.cookie = name + "=" + escape(value) + ";path=/;expires=" + exp.toGMTString();
-}
-
-/**
- * 清空 Cookie
- */
-export function delCookie(): void {
-    let keys = document.cookie.match(/[^ =;]+(?==)/g);
-
-    if (keys) {
-        let date: string = 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
-        }
-    }
-}

package/src/core/dom.ts

@@ -1,47 +0,0 @@
-/**
- * 向父级元素递归搜索
- * 
- * @param _el       当前所在元素
- * @param tagName   目标标签名称
- * @param className 目标元素样式类
- * @returns 目标元素，找不到为 null
- */
-export function up(_el: Element, tagName: string, className: string): Element | null {
-    if (tagName && className)
-        throw '只能任选一种参数，不能同时传';
-
-    let el: Element = _el.parentNode as Element;
-    tagName = tagName && tagName.toUpperCase();
-
-    while (el) {
-        if (tagName && el.tagName == tagName)
-            return el;
-
-        if (className && el.className && ~el.className.indexOf(className))
-            return el;
-
-        el = <Element>el.parentNode;
-    }
-
-    return null;
-}
-
-/**
- * 加载脚本
- * 
- * @param url   脚本地址
- * @param id    脚本元素 id，可选的
- * @param cb    回调函数，可选的
- */
-export function loadScript(url: string, id?: string, cb?: (ev: Event) => any): void {
-    let script: HTMLScriptElement = document.createElement("script");
-    script.src = url;
-
-    if (cb)
-        script.onload = cb;
-
-    if (id)
-        script.id = id;
-
-    document.getElementsByTagName("head")[0].appendChild(script);
-}

package/src/core/utils.ts

@@ -1,179 +0,0 @@
-/**
- * 通用工具类
- */
-
-
-
-/**
- * 是否调试模式中
- * 
- * 打包成组件之后不能用
- * 
- * @returns 
- */
-export function isDebug(): boolean {
-    // @ts-ignore
-    return process.env.NODE_ENV === 'development';
-}
-
-export function isDev(): boolean {
-    let currentHostname: string = 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}
-*/
-export function dateFormat(this: Date, format: string): string {
-    let $1, o: any = {
-        "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: string, value: string;
-    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 格式化后的字符串
- */
-export function dateFormat2(date: Date, fmt: string): string {
-    let o: { [key: string]: number } = {
-        "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 
- */
-export function parallel(arr: [], _finally: Function) {
-    let fn: Function, index: number = 0;
-    // @ts-ignore
-    let statusArr = Array(arr.length).fill().map(() => ({ isActive: false, data: null }));
-
-    let isFinished = function () {
-        return statusArr.every((item: any) => item.isActive === true);
-    }
-
-    let resolve = function (index: number): Function {
-        return function (data: any) {
-            statusArr[index].data = data;
-            statusArr[index].isActive = true;
-            let isFinish = isFinished();
-
-            if (isFinish) {
-                let datas = statusArr.map((item: any) => 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 
- */
-export function throttle(fn: Function, delay: number, mustRunDelay: number): Function {
-    var timer: number, t_start: number;
-
-    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 
-*/
-export function copyToClipboard(text: string): void {
-    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);        // 移除输入框
-    }
-}

package/src/core/xhr-config.ts

@@ -1,25 +0,0 @@
-/**
- * XHR 请求配置
- */
-export interface XhrConfig {
-    /**
-     * 请求头里面的 Content-Type 字段
-     */
-    contentType?: string;
-
-    /**
-     * XHR 响应结果的类型
-     */
-    parseContentType?: 'text' | 'xml' | 'json';
-
-    /**
-     * 超时时间，单位是毫秒
-     * 设为 0 适合不控制超时
-     */
-    timeout?: number;
-
-    /**
-     * 是否跨域
-     */
-    withCredentials?: boolean;
-}

package/src/core/xhr.ts

@@ -1,296 +0,0 @@
-import { XhrConfig } from './xhr-config';
-
-/**
- * 默认的请求配置
- */
-const DEFAULT_XHR_CFG: XhrConfig = {
-    timeout: 5000,
-    withCredentials: false,
-    parseContentType: 'json'
-};
-
-/**
- * 处理响应的回调函数
- */
-type XhrCallback = (json: {}, text: string) => void;
-
-/**
- * 全局请求的 head 参数
- */
-let BASE_HEAD_PARAMS: { [key: string]: any } | null = null;
-
-/**
- * 设置全局请求的 head 参数
- * 
- * @param param 
- */
-export function setBaseHeadParams(params: any): void {
-    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: 'get' | 'delete', url: string, cb: XhrCallback, params?: {}, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    let xhr: XMLHttpRequest = 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: 'post' | 'put', url: string, cb: XhrCallback, params: string | {}, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    let xhr: XMLHttpRequest = 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: string = typeof params != 'string' ? toParams(params) : <string>params;
-
-    if (_params)
-        xhr.send(_params);
-    else
-        xhr.send();
-}
-
-/**
- * 
- * @param url 
- * @param cb 
- * @param params 
- * @param cfg 
- */
-export function xhr_post_upload(url: string, cb: XhrCallback, params: Document | XMLHttpRequestBodyInit, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    let xhr: XMLHttpRequest = 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       配置，可选的
- */
-export function xhr_get(url: string, cb: XhrCallback, params?: {}, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    getOrDel('get', url, cb, params, cfg);
-}
-
-/**
- * XHR DELETE 请求
- * 
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型是json；参数值会进行 URL 编码，最后附加到 QueryString 中
- * @param cfg       配置，可选的
- */
-export function xhr_del(url: string, cb: XhrCallback, params?: {}, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    getOrDel('delete', url, cb, params, cfg);
-}
-
-/**
- * XHR POST 请求
- * 
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型可以是字符串或 json；参数值会进行 URL 编码
- * @param cfg       配置，可选的
- */
-export function xhr_post(url: string, cb: XhrCallback, params: string | {}, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    postOrPut('post', url, cb, params, cfg);
-}
-
-/**
- * XHR PUT 请求
- * 
- * @param url       请求地址
- * @param cb        回调函数 @example (json: {}, text: string) => void;
- * @param params    参数，必填，如无填空字符串 ""；参数类型可以是字符串或 json；参数值会进行 URL 编码
- * @param cfg       配置，可选的
- */
-export function xhr_put(url: string, cb: XhrCallback, params: string | {}, cfg: XhrConfig = DEFAULT_XHR_CFG): void {
-    postOrPut('put', url, cb, params, cfg);
-}
-
-/**
- * 初始化 XHR
- * 
- * @param cfg 
- * @returns 
- */
-function initXhr(cfg: XhrConfig): XMLHttpRequest {
-    let xhr: XMLHttpRequest = new XMLHttpRequest();
-
-    if (cfg && cfg.timeout) {
-        xhr.timeout = cfg.timeout;
-        xhr.ontimeout = (e: ProgressEvent<EventTarget>) => console.error('系统异常，XHR 连接服务超时');
-    }
-
-    if (cfg && cfg.withCredentials)
-        xhr.withCredentials = true;
-
-    return xhr;
-}
-
-/**
- * 错误处理 
- * 
- * @param xhr 
- */
-function errHandle(xhr: XMLHttpRequest): void {
-    let msg: string;
-
-    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: XMLHttpRequest, cb: XhrCallback, cfg: XhrConfig): void {
-    if (xhr.readyState == 4) {
-        if ((xhr.status >= 200 && xhr.status < 300) || xhr.status == 304) {
-            let text: string = xhr.responseText;
-            let json: any;
-
-            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 参数列表
- */
-export function toParams(param: any): string {
-    let result: string = "";
-
-    for (let name in param) {
-        if (typeof param[name] != "function")
-            result += "&" + name + "=" + encodeURIComponent(param[name]);
-    }
-
-    return result.substring(1);
-}
-
-/**
- * 获取 QueryString 的某个参数
- * 
- * @param val 
- * @returns 
-*/
-export function getQuery(val: string): string {
-    const w: number = location.hash.indexOf('?');
-    const query: string = location.hash.substring(w + 1);
-    let vars: string[] = query.split('&');
-
-    for (let i = 0; i < vars.length; i++) {
-        const pair = vars[i].split('=');
-
-        if (pair[0] == val)
-            return pair[1];
-    }
-
-    return '';
-}
-
-export function getPageList(self: any, listArray: any, callback?: Function): XhrCallback {
-    return (j: any) => {
-        if (j.status) {
-            listArray.total = j.total;
-            listArray.data = j.data;
-
-            callback && callback();
-        } else
-            self.$Message.warning(j.message || '获取数据失败');
-    }
-}

package/src/index.ts

@@ -1,6 +0,0 @@
-import * as Cookies from './core/cookies';
-import * as Dom from './core/dom';
-import * as Utils from './core/utils';
-import * as Xhr from './core/xhr';
-
-export { Cookies, Dom, Utils, Xhr };