s94-utils 0.0.1

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "s94-utils",
+  "version": "0.0.1",
+  "description": "",
+  "type": "module",
+  "main": "src/index.js",
+  "module": "src/index.mjs",
+  "exports": {
+    ".": {
+      "import": "src/index.mjs",
+      "require": "src/index.js",
+      "default": "src/index.js"
+    }
+  },
+  "files": ["src"],
+  "sideEffects": false,
+
+  "scripts": {
+    "test": "node test/test.js"
+  },
+  "author": "",
+  "license": "ISC"
+}

package/src/index.js

@@ -0,0 +1,556 @@
+function isPromise(obj){
+    return obj && typeof obj == 'object' && typeof obj.then == 'function';
+}
+
+class Queue{
+    list = [];
+    running = 0;
+    limit = 1;
+    status = 0; // 0，停止，1开始
+
+    /**
+     * 构建队列
+     * @param {number} [limit] 同时执行的槽位数量限制，默认为：1
+     * @param {boolean} [start] 构建好后，是否直接开始队列
+     * @returns {Queue}
+     */
+    constructor(limit, start) {
+        this.limit = limit || 1;
+
+        if (start) this.start()
+        return this;
+    }
+    __run(){
+        while (this.status===1 && this.running < this.limit && this.list.length > 0){
+            let {callback, thisArg} = this.list.shift();
+            let res = callback.call(thisArg);
+
+            if (isPromise(res)){
+                this.running++;
+                res.then(()=>{
+                    this.running--;
+                    this.__run();
+                })
+            }
+        }
+        return this;
+    }
+
+    /**
+     * 插入执行
+     * @param {function} callback 回调函数，如果返回 Promise ，会占用执行槽位直到 Promise 兑现
+     * @param {any} thisArg 执行时的this对象
+     * @returns {Queue}
+     */
+    add(callback, thisArg){
+        if(typeof(callback)!=='function') return this;
+        this.list.push({callback, thisArg});
+        return this.__run();
+    }
+    start(){
+        this.status = 1;
+        return this.__run();
+    }
+    stop(){
+        this.status = 0;
+    }
+}
+
+
+
+class Cache{
+    Storage = null;
+    /**
+     * 构建缓存器，传入缓存引擎对象，
+     * @param { {getItem:(name:string)=>string|Promise<string>, setItem:(name:string, data:any)=>Promise<any>, removeItem?:(name:string)=>Promise<any>, clear?:()=>any } } engine
+     */
+    constructor(engine) {
+        if (typeof(engine)!="object" || typeof(engine.getItem)!='function' || typeof(engine.setItem)!='function'){
+            throw new Error('缓存引擎必须为对象，并且包含方法：getItem、setItem');
+        }
+        this.Storage = engine;
+    }
+
+    /**
+     * 获取缓存
+     * @param {any} name 缓存名
+     * @param {any} def 默认值
+     * @returns {any | Promise<any>} 由引擎的 getItem 确定是否返回 Promise
+     */
+    get(name, def){
+        const cache_name = 's94_cache-'+encode(name);
+        const str = this.Storage.getItem(cache_name);
+        function _get(str, def){
+            try {
+                var data = JSON.parse(str);
+                if(!data || typeof(data)!=='object') return def;
+                if( data['expire'] !== -1 && data['expire'] < (new Date).getTime() ) return def;
+                return data['main'];
+            } catch (error) {
+                return def;
+            }
+        }
+        if (isPromise(str)){
+            return str.then(v=>_get(v, def))
+        }
+        return _get(str, def);
+    }
+    /**
+     * 设定缓存
+     * @param {string} name 缓存名称
+     * @param {any} value 缓存值
+     * @param {number} timeout 过期时间(毫秒)，默认或者小于0，表示永久
+     * @returns {Promise<any>}
+     */
+    set(name, value, timeout){
+        timeout = timeout && timeout>0 ? Number(timeout) : -1;
+        let expire = timeout === -1 ? -1 : (new Date).getTime() + timeout;
+
+        const cache_name = 's94_cache-'+encode(name);
+        const data = JSON.stringify({main:value, expire, name});
+        return Promise.resolve(this.Storage.setItem(cache_name, data));
+    }
+
+    /**
+     * 移除缓存
+     * @param {string} name
+     * @returns {Promise<any>}
+     */
+    remove(name){
+        const cache_name = 's94_cache-'+encode(name);
+        if(typeof(this.Storage.removeItem) === 'function') {
+            return Promise.resolve( this.Storage.removeItem(cache_name) );
+        }else {
+            return Promise.resolve( this.Storage.getItem(cache_name) ).then((res)=>{
+                if (res) {
+                    // 如果有缓存数据，就设定一个保证过期的数据替换
+                    const data = JSON.stringify({main:'', expire:1, name});
+                    return this.Storage.setItem(cache_name, data);
+                }
+                return str
+            })
+        }
+    }
+
+    /**
+     * 清理缓存，如果引擎存在 clear 方法，
+     * @returns {Promise<any>}
+     */
+    clear(){
+        if (typeof(this.Storage.clear) === 'function'){
+            return Promise.resolve( this.Storage.clear() );
+        }
+    }
+}
+
+
+/**
+ * 返回参数的类型，例如 Object，Date
+ * @param {any} obj
+ * @returns {string}
+ */
+function var_type(obj){
+    const str = Object.prototype.toString.call(obj);
+    return str.substring(8,str.length-1);
+}
+/**
+ * 转字符串
+ * @param {any} val
+ * @returns {string}
+ */
+function to_string(val){
+    if (typeof val === 'string') return val;
+    try {
+        return val.toString();
+    } catch (e) {
+        return '';
+    }
+}
+/**
+ * 去除字符串两边的空白
+ * @param {string} str
+ * @param {string} [mask] 额外需要去除的字符串
+ * @returns {string}
+ */
+function trim(str, mask) {
+    str = to_string(str)
+    if (!str) return "";
+    if (typeof str.trim === 'function' && !mask) {
+        return str.trim();
+    }
+    mask = to_string(mask)
+    if (mask) mask = mask.replace(/([\$\(\)\*\+\?\.\[\]\\\^\{\}\|]){1}/g, '\\$1');
+    let reg_code = `^[\\s\\uFEFF\\xA0${mask}]+|[\\s\\uFEFF\\xA0${mask}]+$`
+    return str.replace(new RegExp(reg_code, 'g'), '');
+}
+/**
+ * 计算相对路径
+ * @param {string} path
+ * @param {string} base
+ * @returns {*|string}
+ */
+function path(path, base){
+    if (!base || path.indexOf('/')===0) return path;
+    base = to_string(base);
+    var base_arr = base.split(/\\|\//);
+    base_arr.pop();
+    for (var i=0,path_arr = path.split(/\\|\//); i<path_arr.length; i++) {
+        switch (path_arr[i]){
+            case '.':break;
+            case '..':base_arr.pop();break;
+            default:base_arr.push(path_arr[i]);break;
+        }
+    }
+    return base_arr.join(~base.indexOf('\\') ? '\\' : '/');
+}
+/**
+ * 遍历对象
+ * @param {Object} obj
+ * @param { {each:(v:any, k:string, obj:Object)=>any, over?:()=>any, limit?:number} | ((v:any, k:string, obj:Object)=>any) } op 遍历回调函数 或者 包含遍历回调的配置
+ * @param {any} [thisArg] 回调函数的this对象
+ */
+function each(obj, op, thisArg) {
+    let ks = Object.keys(obj), index=0;
+    if (typeof op == 'function') op = {each: op}
+    if (typeof op.each != 'function') throw '参数错误，缺少遍历回调函数(each)';
+    op.over = typeof op.over == 'function' ? op.over : function (){}
+    let runing = 0, limit = op.limit || 1, is_break = false;
+
+    function __run(){
+        while (runing < limit && index < ks.length && !is_break){
+            let k = ks[index++], v = obj[k];
+            let res = op.each.call( (thisArg || v), v, k, obj );
+            if (res === false) {
+                op.over()
+                is_break=true;
+            }else if (isPromise(res)){
+                runing++;
+                res.then(()=>{
+                    runing--;
+                    __run();
+                }).catch(()=>{op.over();is_break=true;})
+            }
+        }
+        if (!is_break && !runing && index >= ks.length) op.over()
+    }
+    __run();
+}
+/**
+ * 递归遍历
+ * @param {Object} obj 遍历的对象
+ * @param {string} childkey 递归遍历子对象的参数名，如果为空表示遍历整个子对象
+ * @param { (v:any, k:string, obj:Object, ks:string[])=>any } callback 遍历回调函数
+ * @param {boolean} [is_layer] 是否按层结构（0,1,00,01,10...）递归，false表示按树结构（0,00,01,1,10...）
+ * @param {any} [thisArg] 遍历回调的this，默认为子对象
+ */
+function eachloop(obj, childkey, callback, is_layer, thisArg) {
+    function loop(obj, ks){
+        let next_layer = [];
+        let res = true;
+        for (const k in obj) {
+            if (!obj.hasOwnProperty(k)) continue;
+            let row = obj[k];
+            res = callback.call( (thisArg || row), row, k, obj, ks.concat(k) );
+            if (res && row && typeof(row)=="object") {
+                let child = childkey ? row[childkey] : row;
+                if (child && typeof(child)=="object") {
+                    if (is_layer){
+                        next_layer.push({child:child, ks:ks.concat(k)})
+                    }else {
+                        res = loop(child, ks.concat(k));
+                    }
+                }
+            }
+            if (res === false) break;
+        }
+        for (let i = 0; i < next_layer.length; i++) {
+            let row = next_layer[i];
+            res = loop(row.child, row.ks);
+            if (res === false) break;
+        }
+        return res;
+    }
+    loop(obj, [])
+}
+/**
+ * url查询参数解码
+ * @param {string} str url查询参数字符串，例如：a=1&b[]=2&b[]=3
+ * @returns {{[key:string]: string|Object}}
+ */
+function param_decode(str){
+    let res = {};
+    if (!str || typeof str !== 'string') return res;
+    str.split('&').forEach(function (row){
+        let kv = row.split('=');
+        if (!kv[0]) return;
+        let val = decodeURIComponent(kv[1] || '');
+        let arr = decodeURIComponent(kv[0]).split(']'), ks=[];
+        for (let i = 0; i < arr.length; i++) {
+            let row = arr[i];
+            if (i===0){
+                let ms = row.match(/^([^\[]+)(\[[\s\S.]*)?$/);
+                ks.push(ms[1]);
+                if (ms[2]) ks.push(ms[2].substring(1));
+            }else if(row){
+                ks.push(row.substring(1));
+            }else {
+                break;
+            }
+        }
+        let cache = res;
+        ks.forEach(function (k,i){
+            k = k || (function(){
+                var ki=-1;
+                Object.keys(cache).forEach(function(row){
+                    if(/^\d+$/.test(row) && row>ki) ki = row*1;
+                })
+                return ki+1;
+            })();
+            if (i == ks.length-1){
+                cache[k] = val;
+            }else {
+                let is_arr = ks[i+1] == '' || /^\d+$/.test(ks[i+1]);
+                cache[k] = typeof(cache[k])!="undefined" ? cache[k] : (is_arr ? [] : {});
+                cache = cache[k];
+            }
+        })
+    })
+    return res;
+}
+/**
+ * url查询参数编码
+ * @param {Object} obj 数据对象
+ * @returns {string}
+ */
+function param_encode(obj){
+    if (!obj) return '';
+    if(typeof(obj)=='string') return obj;
+    let param_arr = [];
+    if (obj instanceof FormData){
+        for(let pair of obj.entries()) {
+            param_arr.push(encodeURIComponent(pair[0]) + '=' + encodeURIComponent(pair[1]) );
+        }
+    }else{
+        eachloop(obj, '', function (row, k, all, ks){
+            if(typeof(row) !== "object") {
+                let name = ks.map((v,i)=>{ return i>0 ? '['+encodeURIComponent(v)+']' : encodeURIComponent(v); }).join('');
+                param_arr.push(name + '=' + encodeURIComponent(row));
+            }
+            return true;
+        })
+    }
+    return param_arr.join('&');
+}
+/**
+ * 数据签名
+ * @param {any} data 数据
+ * @param {number} len 长度， 默认64
+ * @returns {string}
+ */
+function encode(data, len=64){
+    if (!data) return '';
+    let strmap = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-';
+    len  = len && len>1 && len<=64 ? Number(len) : 64;
+    let str = JSON.stringify(data).replaceAll('"','');
+    let res = '', vi = 0;
+    for (let j = 0; j < len; j++) {
+        for (let i = j; i < str.length; i+=len) {
+            vi += str.charCodeAt(i);
+        }
+        let v = vi%len;
+        res += strmap[vi%len];
+        vi = Math.floor(vi/len);
+    }
+    return res;
+}
+/**
+ * 对象的指定值获取 或者 设定
+ * @param {any} data 数据源
+ * @param {string|{[key:string]: any}} key_data 获取的键，或者设定数据的键值对
+ * @param {any} def 值不存在的默认值
+ * @returns {*}
+ */
+function map(data, key_data, def){
+    if (typeof(key_data) == 'object' && key_data){
+        if(data === null || typeof data !== 'object') data = {};
+        for (const key in key_data) {
+            if (!key.length) continue;
+            let v = key_data[key];
+            let key_arr = key.split('.');
+            let k_last = key_arr.pop();
+            let cache_data = data;
+            key_arr.forEach(function (k, i){
+                if (cache_data[k] === null || typeof cache_data[k] !== 'object'){
+                    cache_data[k] = {}
+                }
+                cache_data = cache_data[k];
+            })
+            cache_data[k_last] = v;
+        }
+        return data;
+    }else {
+        let key_arr = key_data ? to_string(key_data).split('.') : [];
+        let res = data;
+        for (let i = 0; i < key_arr.length; i++) {
+            let k = key_arr[i];
+            if (res === null || typeof res === 'undefined') return def;
+            res = res[k];
+        }
+        if (res === null || typeof res === 'undefined') return def;
+        return res;
+    }
+}
+
+/**
+ * 日期处理
+ * @param {string|number|Date} date 日期，可以是字符串、时间戳(毫秒)
+ * @param {string} fmt 日期字符串格式，如果data为字符串，然后fmt为空，那么会推定日期为 年月日时分秒、日月年时分秒 中的一种
+ * @param {number} [zone] 时区，东正，西负。-12~12
+ * @returns {{timestamp: number, y: number, m: number, d: number, h: number, i: number, s: number, w: number, string: string, zone: number}}
+ */
+function date(date, fmt, zone){
+    function utc_date(str, fmt, utc_offset){
+        // 宽松的日期解析，按 fmt 指定的标识顺序位置的数字
+        let number_arr = str.match(/\d+/g);
+        let key_arr = []
+        if (fmt){
+            fmt = fmt.replace(/\\[ymdhis]/ig, ''); // 排除掉 \Y 之类的转义字符
+            key_arr = fmt.match(/[ymdhis]/ig);
+        } else {
+            // 没有指定 fmt 的情况下，根据年(值>1000)所在位置判断，分两种情况：年月日时分秒、日月年时分秒
+            let year_index = number_arr.findIndex(v=>v>1000)
+            if (year_index === 0){
+                key_arr = ['y','m','d','h','i','s']
+            }else if (year_index === 2){
+                key_arr = ['d','m','y','h','i','s']
+            }else {
+                throw new Error('日期异常')
+            }
+        }
+        let value_map = {}
+        key_arr.forEach((k, i)=>{
+            value_map[k.toLowerCase()] = Number(number_arr[i] || 0)
+        })
+        let date = new Date()
+        let function_map = { y:'setUTCFullYear',m:'setUTCMonth',d:'setUTCDate',h:'setUTCHours',i:'setUTCMinutes',s:'setUTCSeconds' };
+        Object.keys(function_map).forEach(k=>{
+            value_map[k] = value_map[k] || 0;
+            if (k === 'm' && value_map[k] === 0){
+                // 月的默认值应该是 1 不是 0
+                value_map[k] = 1
+            }
+            let function_name = function_map[k]
+            date[function_name]( k==='m' ? value_map[k]-1 : value_map[k] );
+        })
+        value_map.w = date.getUTCDay();
+        // 时区转换，例如：在东8时区传入的是1970 年 1 月 1 日 08:00:00。因为使用的是 setUTCHours ，得到的 date.getTime() = 8*60*1000，
+        value_map.timestamp = date.getTime() - utc_offset;
+        return value_map;
+    }
+    function format_time(timestamp, fmt, utc_offset){
+        const time = new Date(timestamp + utc_offset)
+        function add0(n){ return n < 10 ? ('0' + n) : n}
+        let res = {
+            y: time.getUTCFullYear(),
+            m: time.getUTCMonth() + 1,
+            d: time.getUTCDate(),
+            h: time.getUTCHours(),
+            i: time.getUTCMinutes(),
+            s: time.getUTCSeconds(),
+            w: time.getUTCDay(),
+        }
+        let v = {
+            ...res,
+            W: ['日','一','二','三','四','五','六'][res.w],
+            w: ['7','1','2','3','4','5','6'][res.w],
+        }
+        v.Y = v.y; v.M = add0(v.m); v.D = add0(v.d); v.H = add0(v.h); v.I = add0(v.i); v.S = add0(v.s);
+        res.string = fmt.replace(/(^|[^\\])([YMDHISWymdhisw]+)/g, function(m,m1,m2){
+            let str = m1;
+            for(let i=0; i<m2.length; i++ ){
+                str += v[m2[i]];
+            }
+            return str;
+        }).replace(/\\([YMDHISWymdhisw])/g, "$1");
+        return res;
+    }
+
+    zone = Number(zone);
+    // utc需要偏移多少毫秒后，才能得到和指定时区相同的日期，例如：东8时区8点时，utc得到的是0点，需要+480分钟后，utc得到的才是8点，那么 utc_offset=480*60*1000
+    // 即：(new Date(时间戳)).getHours() == (new Date(时间戳 + utc_offset)).getUTCHours()
+    if (isNaN(zone)){
+        zone = -(new Date()).getTimezoneOffset()/60
+    }
+    const utc_offset = zone*3600*1000;
+
+    const res = {
+        timestamp: NaN,
+        y: NaN,
+        m: NaN,
+        d: NaN,
+        h: NaN,
+        i: NaN,
+        s: NaN,
+        w: NaN,
+        string: '',
+        zone,
+    }
+    if (date instanceof Date){
+        let timestamp = date.getTime();
+        Object.assign(res, format_time(timestamp, fmt, utc_offset))
+        res.timestamp = timestamp;
+    }else if (typeof date === 'number'){
+        Object.assign(res, format_time(date, fmt, utc_offset))
+        res.timestamp = date;
+    }else if (typeof date === 'string'){
+        Object.assign(res, utc_date(date, fmt, utc_offset))
+        res.string = date;
+    }
+    return res;
+}
+
+const s94_event = {
+    __event_list: {},
+    on(event_name, callback, first){
+        if (!event_name || typeof event_name !== 'string') return;
+        if (typeof callback !== 'function') return;
+        let list = s94_event.__event_list[event_name] || [];
+        first ? list.unshift(callback) : list.push(callback);
+        s94_event.__event_list[event_name] = list;
+    },
+    off(event_name, callback){
+        if (!event_name || typeof event_name !== 'string') return;
+        if (typeof callback === 'function'){
+            let list = s94_event.__event_list[event_name] || [];
+            let i = list.indexOf(callback);
+            if (i !== -1) list.splice(i,1);
+            s94_event.__event_list[event_name] = list;
+        }else if (typeof callback === 'undefined'){
+            s94_event.__event_list[event_name] = [];
+        }
+    },
+    emit(event_name, data, thisArg){
+        if (!event_name || typeof event_name !== 'string') return;
+        let list = s94_event.__event_list[event_name] || [];
+        for (let i = 0; i < list; i++) {
+            if (list[i].call(thisArg, data) === false) break;
+        }
+    },
+}
+
+module.exports = {
+    Queue,
+    Cache,
+    var_type,
+    to_string,
+    trim,
+    path,
+    each,
+    eachloop,
+    param_decode,
+    param_encode,
+    encode,
+    map,
+    date,
+    s94_event,
+}

package/src/index.mjs

@@ -0,0 +1,556 @@
+function isPromise(obj){
+    return obj && typeof obj == 'object' && typeof obj.then == 'function';
+}
+
+class Queue{
+    list = [];
+    running = 0;
+    limit = 1;
+    status = 0; // 0，停止，1开始
+
+    /**
+     * 构建队列
+     * @param {number} [limit] 同时执行的槽位数量限制，默认为：1
+     * @param {boolean} [start] 构建好后，是否直接开始队列
+     * @returns {Queue}
+     */
+    constructor(limit, start) {
+        this.limit = limit || 1;
+
+        if (start) this.start()
+        return this;
+    }
+    __run(){
+        while (this.status===1 && this.running < this.limit && this.list.length > 0){
+            let {callback, thisArg} = this.list.shift();
+            let res = callback.call(thisArg);
+
+            if (isPromise(res)){
+                this.running++;
+                res.then(()=>{
+                    this.running--;
+                    this.__run();
+                })
+            }
+        }
+        return this;
+    }
+
+    /**
+     * 插入执行
+     * @param {function} callback 回调函数，如果返回 Promise ，会占用执行槽位直到 Promise 兑现
+     * @param {any} thisArg 执行时的this对象
+     * @returns {Queue}
+     */
+    add(callback, thisArg){
+        if(typeof(callback)!=='function') return this;
+        this.list.push({callback, thisArg});
+        return this.__run();
+    }
+    start(){
+        this.status = 1;
+        return this.__run();
+    }
+    stop(){
+        this.status = 0;
+    }
+}
+
+
+
+class Cache{
+    Storage = null;
+    /**
+     * 构建缓存器，传入缓存引擎对象，
+     * @param { {getItem:(name:string)=>string|Promise<string>, setItem:(name:string, data:any)=>Promise<any>, removeItem?:(name:string)=>Promise<any>, clear?:()=>any } } engine
+     */
+    constructor(engine) {
+        if (typeof(engine)!="object" || typeof(engine.getItem)!='function' || typeof(engine.setItem)!='function'){
+            throw new Error('缓存引擎必须为对象，并且包含方法：getItem、setItem');
+        }
+        this.Storage = engine;
+    }
+
+    /**
+     * 获取缓存
+     * @param {any} name 缓存名
+     * @param {any} def 默认值
+     * @returns {any | Promise<any>} 由引擎的 getItem 确定是否返回 Promise
+     */
+    get(name, def){
+        const cache_name = 's94_cache-'+encode(name);
+        const str = this.Storage.getItem(cache_name);
+        function _get(str, def){
+            try {
+                var data = JSON.parse(str);
+                if(!data || typeof(data)!=='object') return def;
+                if( data['expire'] !== -1 && data['expire'] < (new Date).getTime() ) return def;
+                return data['main'];
+            } catch (error) {
+                return def;
+            }
+        }
+        if (isPromise(str)){
+            return str.then(v=>_get(v, def))
+        }
+        return _get(str, def);
+    }
+    /**
+     * 设定缓存
+     * @param {string} name 缓存名称
+     * @param {any} value 缓存值
+     * @param {number} timeout 过期时间(毫秒)，默认或者小于0，表示永久
+     * @returns {Promise<any>}
+     */
+    set(name, value, timeout){
+        timeout = timeout && timeout>0 ? Number(timeout) : -1;
+        let expire = timeout === -1 ? -1 : (new Date).getTime() + timeout;
+
+        const cache_name = 's94_cache-'+encode(name);
+        const data = JSON.stringify({main:value, expire, name});
+        return Promise.resolve(this.Storage.setItem(cache_name, data));
+    }
+
+    /**
+     * 移除缓存
+     * @param {string} name
+     * @returns {Promise<any>}
+     */
+    remove(name){
+        const cache_name = 's94_cache-'+encode(name);
+        if(typeof(this.Storage.removeItem) === 'function') {
+            return Promise.resolve( this.Storage.removeItem(cache_name) );
+        }else {
+            return Promise.resolve( this.Storage.getItem(cache_name) ).then((res)=>{
+                if (res) {
+                    // 如果有缓存数据，就设定一个保证过期的数据替换
+                    const data = JSON.stringify({main:'', expire:1, name});
+                    return this.Storage.setItem(cache_name, data);
+                }
+                return str
+            })
+        }
+    }
+
+    /**
+     * 清理缓存，如果引擎存在 clear 方法，
+     * @returns {Promise<any>}
+     */
+    clear(){
+        if (typeof(this.Storage.clear) === 'function'){
+            return Promise.resolve( this.Storage.clear() );
+        }
+    }
+}
+
+
+/**
+ * 返回参数的类型，例如 Object，Date
+ * @param {any} obj
+ * @returns {string}
+ */
+function var_type(obj){
+    const str = Object.prototype.toString.call(obj);
+    return str.substring(8,str.length-1);
+}
+/**
+ * 转字符串
+ * @param {any} val
+ * @returns {string}
+ */
+function to_string(val){
+    if (typeof val === 'string') return val;
+    try {
+        return val.toString();
+    } catch (e) {
+        return '';
+    }
+}
+/**
+ * 去除字符串两边的空白
+ * @param {string} str
+ * @param {string} [mask] 额外需要去除的字符串
+ * @returns {string}
+ */
+function trim(str, mask) {
+    str = to_string(str)
+    if (!str) return "";
+    if (typeof str.trim === 'function' && !mask) {
+        return str.trim();
+    }
+    mask = to_string(mask)
+    if (mask) mask = mask.replace(/([\$\(\)\*\+\?\.\[\]\\\^\{\}\|]){1}/g, '\\$1');
+    let reg_code = `^[\\s\\uFEFF\\xA0${mask}]+|[\\s\\uFEFF\\xA0${mask}]+$`
+    return str.replace(new RegExp(reg_code, 'g'), '');
+}
+/**
+ * 计算相对路径
+ * @param {string} path
+ * @param {string} base
+ * @returns {*|string}
+ */
+function path(path, base){
+    if (!base || path.indexOf('/')===0) return path;
+    base = to_string(base);
+    var base_arr = base.split(/\\|\//);
+    base_arr.pop();
+    for (var i=0,path_arr = path.split(/\\|\//); i<path_arr.length; i++) {
+        switch (path_arr[i]){
+            case '.':break;
+            case '..':base_arr.pop();break;
+            default:base_arr.push(path_arr[i]);break;
+        }
+    }
+    return base_arr.join(~base.indexOf('\\') ? '\\' : '/');
+}
+/**
+ * 遍历对象
+ * @param {Object} obj
+ * @param { {each:(v:any, k:string, obj:Object)=>any, over?:()=>any, limit?:number} | ((v:any, k:string, obj:Object)=>any) } op 遍历回调函数 或者 包含遍历回调的配置
+ * @param {any} [thisArg] 回调函数的this对象
+ */
+function each(obj, op, thisArg) {
+    let ks = Object.keys(obj), index=0;
+    if (typeof op == 'function') op = {each: op}
+    if (typeof op.each != 'function') throw '参数错误，缺少遍历回调函数(each)';
+    op.over = typeof op.over == 'function' ? op.over : function (){}
+    let runing = 0, limit = op.limit || 1, is_break = false;
+
+    function __run(){
+        while (runing < limit && index < ks.length && !is_break){
+            let k = ks[index++], v = obj[k];
+            let res = op.each.call( (thisArg || v), v, k, obj );
+            if (res === false) {
+                op.over()
+                is_break=true;
+            }else if (isPromise(res)){
+                runing++;
+                res.then(()=>{
+                    runing--;
+                    __run();
+                }).catch(()=>{op.over();is_break=true;})
+            }
+        }
+        if (!is_break && !runing && index >= ks.length) op.over()
+    }
+    __run();
+}
+/**
+ * 递归遍历
+ * @param {Object} obj 遍历的对象
+ * @param {string} childkey 递归遍历子对象的参数名，如果为空表示遍历整个子对象
+ * @param { (v:any, k:string, obj:Object, ks:string[])=>any } callback 遍历回调函数
+ * @param {boolean} [is_layer] 是否按层结构（0,1,00,01,10...）递归，false表示按树结构（0,00,01,1,10...）
+ * @param {any} [thisArg] 遍历回调的this，默认为子对象
+ */
+function eachloop(obj, childkey, callback, is_layer, thisArg) {
+    function loop(obj, ks){
+        let next_layer = [];
+        let res = true;
+        for (const k in obj) {
+            if (!obj.hasOwnProperty(k)) continue;
+            let row = obj[k];
+            res = callback.call( (thisArg || row), row, k, obj, ks.concat(k) );
+            if (res && row && typeof(row)=="object") {
+                let child = childkey ? row[childkey] : row;
+                if (child && typeof(child)=="object") {
+                    if (is_layer){
+                        next_layer.push({child:child, ks:ks.concat(k)})
+                    }else {
+                        res = loop(child, ks.concat(k));
+                    }
+                }
+            }
+            if (res === false) break;
+        }
+        for (let i = 0; i < next_layer.length; i++) {
+            let row = next_layer[i];
+            res = loop(row.child, row.ks);
+            if (res === false) break;
+        }
+        return res;
+    }
+    loop(obj, [])
+}
+/**
+ * url查询参数解码
+ * @param {string} str url查询参数字符串，例如：a=1&b[]=2&b[]=3
+ * @returns {{[key:string]: string|Object}}
+ */
+function param_decode(str){
+    let res = {};
+    if (!str || typeof str !== 'string') return res;
+    str.split('&').forEach(function (row){
+        let kv = row.split('=');
+        if (!kv[0]) return;
+        let val = decodeURIComponent(kv[1] || '');
+        let arr = decodeURIComponent(kv[0]).split(']'), ks=[];
+        for (let i = 0; i < arr.length; i++) {
+            let row = arr[i];
+            if (i===0){
+                let ms = row.match(/^([^\[]+)(\[[\s\S.]*)?$/);
+                ks.push(ms[1]);
+                if (ms[2]) ks.push(ms[2].substring(1));
+            }else if(row){
+                ks.push(row.substring(1));
+            }else {
+                break;
+            }
+        }
+        let cache = res;
+        ks.forEach(function (k,i){
+            k = k || (function(){
+                var ki=-1;
+                Object.keys(cache).forEach(function(row){
+                    if(/^\d+$/.test(row) && row>ki) ki = row*1;
+                })
+                return ki+1;
+            })();
+            if (i == ks.length-1){
+                cache[k] = val;
+            }else {
+                let is_arr = ks[i+1] == '' || /^\d+$/.test(ks[i+1]);
+                cache[k] = typeof(cache[k])!="undefined" ? cache[k] : (is_arr ? [] : {});
+                cache = cache[k];
+            }
+        })
+    })
+    return res;
+}
+/**
+ * url查询参数编码
+ * @param {Object} obj 数据对象
+ * @returns {string}
+ */
+function param_encode(obj){
+    if (!obj) return '';
+    if(typeof(obj)=='string') return obj;
+    let param_arr = [];
+    if (obj instanceof FormData){
+        for(let pair of obj.entries()) {
+            param_arr.push(encodeURIComponent(pair[0]) + '=' + encodeURIComponent(pair[1]) );
+        }
+    }else{
+        eachloop(obj, '', function (row, k, all, ks){
+            if(typeof(row) !== "object") {
+                let name = ks.map((v,i)=>{ return i>0 ? '['+encodeURIComponent(v)+']' : encodeURIComponent(v); }).join('');
+                param_arr.push(name + '=' + encodeURIComponent(row));
+            }
+            return true;
+        })
+    }
+    return param_arr.join('&');
+}
+/**
+ * 数据签名
+ * @param {any} data 数据
+ * @param {number} len 长度， 默认64
+ * @returns {string}
+ */
+function encode(data, len=64){
+    if (!data) return '';
+    let strmap = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-';
+    len  = len && len>1 && len<=64 ? Number(len) : 64;
+    let str = JSON.stringify(data).replaceAll('"','');
+    let res = '', vi = 0;
+    for (let j = 0; j < len; j++) {
+        for (let i = j; i < str.length; i+=len) {
+            vi += str.charCodeAt(i);
+        }
+        let v = vi%len;
+        res += strmap[vi%len];
+        vi = Math.floor(vi/len);
+    }
+    return res;
+}
+/**
+ * 对象的指定值获取 或者 设定
+ * @param {any} data 数据源
+ * @param {string|{[key:string]: any}} key_data 获取的键，或者设定数据的键值对
+ * @param {any} def 值不存在的默认值
+ * @returns {*}
+ */
+function map(data, key_data, def){
+    if (typeof(key_data) == 'object' && key_data){
+        if(data === null || typeof data !== 'object') data = {};
+        for (const key in key_data) {
+            if (!key.length) continue;
+            let v = key_data[key];
+            let key_arr = key.split('.');
+            let k_last = key_arr.pop();
+            let cache_data = data;
+            key_arr.forEach(function (k, i){
+                if (cache_data[k] === null || typeof cache_data[k] !== 'object'){
+                    cache_data[k] = {}
+                }
+                cache_data = cache_data[k];
+            })
+            cache_data[k_last] = v;
+        }
+        return data;
+    }else {
+        let key_arr = key_data ? to_string(key_data).split('.') : [];
+        let res = data;
+        for (let i = 0; i < key_arr.length; i++) {
+            let k = key_arr[i];
+            if (res === null || typeof res === 'undefined') return def;
+            res = res[k];
+        }
+        if (res === null || typeof res === 'undefined') return def;
+        return res;
+    }
+}
+
+/**
+ * 日期处理
+ * @param {string|number|Date} date 日期，可以是字符串、时间戳(毫秒)
+ * @param {string} fmt 日期字符串格式，如果data为字符串，然后fmt为空，那么会推定日期为 年月日时分秒、日月年时分秒 中的一种
+ * @param {number} [zone] 时区，东正，西负。-12~12
+ * @returns {{timestamp: number, y: number, m: number, d: number, h: number, i: number, s: number, w: number, string: string, zone: number}}
+ */
+function date(date, fmt, zone){
+    function utc_date(str, fmt, utc_offset){
+        // 宽松的日期解析，按 fmt 指定的标识顺序位置的数字
+        let number_arr = str.match(/\d+/g);
+        let key_arr = []
+        if (fmt){
+            fmt = fmt.replace(/\\[ymdhis]/ig, ''); // 排除掉 \Y 之类的转义字符
+            key_arr = fmt.match(/[ymdhis]/ig);
+        } else {
+            // 没有指定 fmt 的情况下，根据年(值>1000)所在位置判断，分两种情况：年月日时分秒、日月年时分秒
+            let year_index = number_arr.findIndex(v=>v>1000)
+            if (year_index === 0){
+                key_arr = ['y','m','d','h','i','s']
+            }else if (year_index === 2){
+                key_arr = ['d','m','y','h','i','s']
+            }else {
+                throw new Error('日期异常')
+            }
+        }
+        let value_map = {}
+        key_arr.forEach((k, i)=>{
+            value_map[k.toLowerCase()] = Number(number_arr[i] || 0)
+        })
+        let date = new Date()
+        let function_map = { y:'setUTCFullYear',m:'setUTCMonth',d:'setUTCDate',h:'setUTCHours',i:'setUTCMinutes',s:'setUTCSeconds' };
+        Object.keys(function_map).forEach(k=>{
+            value_map[k] = value_map[k] || 0;
+            if (k === 'm' && value_map[k] === 0){
+                // 月的默认值应该是 1 不是 0
+                value_map[k] = 1
+            }
+            let function_name = function_map[k]
+            date[function_name]( k==='m' ? value_map[k]-1 : value_map[k] );
+        })
+        value_map.w = date.getUTCDay();
+        // 时区转换，例如：在东8时区传入的是1970 年 1 月 1 日 08:00:00。因为使用的是 setUTCHours ，得到的 date.getTime() = 8*60*1000，
+        value_map.timestamp = date.getTime() - utc_offset;
+        return value_map;
+    }
+    function format_time(timestamp, fmt, utc_offset){
+        const time = new Date(timestamp + utc_offset)
+        function add0(n){ return n < 10 ? ('0' + n) : n}
+        let res = {
+            y: time.getUTCFullYear(),
+            m: time.getUTCMonth() + 1,
+            d: time.getUTCDate(),
+            h: time.getUTCHours(),
+            i: time.getUTCMinutes(),
+            s: time.getUTCSeconds(),
+            w: time.getUTCDay(),
+        }
+        let v = {
+            ...res,
+            W: ['日','一','二','三','四','五','六'][res.w],
+            w: ['7','1','2','3','4','5','6'][res.w],
+        }
+        v.Y = v.y; v.M = add0(v.m); v.D = add0(v.d); v.H = add0(v.h); v.I = add0(v.i); v.S = add0(v.s);
+        res.string = fmt.replace(/(^|[^\\])([YMDHISWymdhisw]+)/g, function(m,m1,m2){
+            let str = m1;
+            for(let i=0; i<m2.length; i++ ){
+                str += v[m2[i]];
+            }
+            return str;
+        }).replace(/\\([YMDHISWymdhisw])/g, "$1");
+        return res;
+    }
+
+    zone = Number(zone);
+    // utc需要偏移多少毫秒后，才能得到和指定时区相同的日期，例如：东8时区8点时，utc得到的是0点，需要+480分钟后，utc得到的才是8点，那么 utc_offset=480*60*1000
+    // 即：(new Date(时间戳)).getHours() == (new Date(时间戳 + utc_offset)).getUTCHours()
+    if (isNaN(zone)){
+        zone = -(new Date()).getTimezoneOffset()/60
+    }
+    const utc_offset = zone*3600*1000;
+
+    const res = {
+        timestamp: NaN,
+        y: NaN,
+        m: NaN,
+        d: NaN,
+        h: NaN,
+        i: NaN,
+        s: NaN,
+        w: NaN,
+        string: '',
+        zone,
+    }
+    if (date instanceof Date){
+        let timestamp = date.getTime();
+        Object.assign(res, format_time(timestamp, fmt, utc_offset))
+        res.timestamp = timestamp;
+    }else if (typeof date === 'number'){
+        Object.assign(res, format_time(date, fmt, utc_offset))
+        res.timestamp = date;
+    }else if (typeof date === 'string'){
+        Object.assign(res, utc_date(date, fmt, utc_offset))
+        res.string = date;
+    }
+    return res;
+}
+
+const s94_event = {
+    __event_list: {},
+    on(event_name, callback, first){
+        if (!event_name || typeof event_name !== 'string') return;
+        if (typeof callback !== 'function') return;
+        let list = s94_event.__event_list[event_name] || [];
+        first ? list.unshift(callback) : list.push(callback);
+        s94_event.__event_list[event_name] = list;
+    },
+    off(event_name, callback){
+        if (!event_name || typeof event_name !== 'string') return;
+        if (typeof callback === 'function'){
+            let list = s94_event.__event_list[event_name] || [];
+            let i = list.indexOf(callback);
+            if (i !== -1) list.splice(i,1);
+            s94_event.__event_list[event_name] = list;
+        }else if (typeof callback === 'undefined'){
+            s94_event.__event_list[event_name] = [];
+        }
+    },
+    emit(event_name, data, thisArg){
+        if (!event_name || typeof event_name !== 'string') return;
+        let list = s94_event.__event_list[event_name] || [];
+        for (let i = 0; i < list; i++) {
+            if (list[i].call(thisArg, data) === false) break;
+        }
+    },
+}
+
+export {
+    Queue,
+    Cache,
+    var_type,
+    to_string,
+    trim,
+    path,
+    each,
+    eachloop,
+    param_decode,
+    param_encode,
+    encode,
+    map,
+    date,
+    s94_event,
+}