@haluo/util 2.0.33 → 2.0.34

package/dist/modules/tools/index.js

@@ -3,19 +3,99 @@
  * @Author: wanghui
  */
 'use strict';
-let previous = 0;
-let timeout = null;
+var previous = 0;
+var timeout = null;
 import cloneDeep from 'lodash/cloneDeep';
 import copy from 'clipboard-copy';
-class ToolsClass {
-    constructor() {
+var ToolsClass = /** @class */ (function () {
+    function ToolsClass() {
+        var _this = this;
+        /**
+         * 蒙层显示后，html禁止滚动操作
+         * @param {String} className
+         * @return {Void}
+         */
+        this.stopScroll = function (className) {
+            if (!(window && window.document)) {
+                return new Error('仅支持浏览器');
+            }
+            var html = document.documentElement;
+            html.style.overflow = 'hidden';
+            html.style.height = '100%';
+            var body = document.body;
+            body.style.overflow = 'hidden';
+            body.style.height = '100%';
+            if (className) {
+                var dom = document.querySelector(".".concat(className));
+                dom && dom.addEventListener('touchmove', _this.__setDefault__);
+            }
+        };
+        /**
+         * 蒙层隐藏后，html开启滚动操作
+         * @param {String} className
+         * @return {Void}
+         */
+        this.startScroll = function (className) {
+            if (!(window && window.document)) {
+                return new Error('仅支持浏览器');
+            }
+            var html = document.documentElement;
+            html.style.overflow = 'visible';
+            html.style.height = 'auto';
+            var body = document.body;
+            body.style.overflow = 'visible';
+            body.style.height = 'auto';
+            if (className) {
+                var dom = document.querySelector(".".concat(className));
+                dom && dom.removeEventListener('touchmove', _this.__setDefault__);
+            }
+        };
+        /**
+       * object 对象转 array 数组
+       * demo:
+       *  objectToArray({a:1,b:2})  输出：["a=1", "b=2"]
+       * @param {Object} obj
+       * @returns {Array} arr
+       */
+        this.objectToArray = function (obj) {
+            var arr = [];
+            if (typeof obj === 'object') {
+                for (var key in obj) {
+                    if (obj.hasOwnProperty(key)) {
+                        arr.push([key, obj[key]].join('='));
+                    }
+                }
+            }
+            return arr;
+        };
+        /**
+        * convertEnum
+        * 枚举键值互换
+        * @param {Object} obj
+        * convertKeyValueEnum({a: 1, b: 2}) // {1: "a", 2: "b"}
+        * @returns {Object} result
+        */
+        this.convertKeyValueEnum = function (obj) {
+            var result = {};
+            if (typeof obj === 'object') {
+                for (var key in obj) {
+                    if (obj.hasOwnProperty(key)) {
+                        result[obj[key]] = key;
+                    }
+                }
+            }
+            return result;
+        };
+        this.isDefined = function (val) {
+            return val !== undefined && val !== null;
+        };
         this.__loaded__ = {}; // 已加载的资源
         /**
          * 阻止事件传递
          * @param {Event} e
          * @return {Void}
          */
-        this.__setDefault__ = (e) => {
+        this.__setDefault__ = function (e) {
             e && e.preventDefault();
         };
     }
@@ -25,31 +105,31 @@ class ToolsClass {
      * @param {String} data
      * @return {Object}
      */
-    deepCopy(data) {
+    ToolsClass.prototype.deepCopy = function (data) {
         return JSON.parse(JSON.stringify(data));
-    }
+    };
     /**
      * 深拷贝 Object|Array
      * 支持 普通对象、数组和函数的深复制，但是未解决循环引用、Date、RegExp
      * @param {Object|Array} data
      * @return {Object}
      */
-    deepCopy2(obj) {
-        const _obj = Array.isArray(obj) ? [] : {};
-        for (const i in obj) {
+    ToolsClass.prototype.deepCopy2 = function (obj) {
+        var _obj = Array.isArray(obj) ? [] : {};
+        for (var i in obj) {
             _obj[i] = typeof obj[i] === 'object' ? this.deepCopy2(obj[i]) : obj[i];
         }
         return _obj;
-    }
+    };
     /**
      * 深拷贝 Object|Array
      * 注意：需要 yarn add lodash
      * @param {Object|Array} data
      * @return {Object}
      */
-    deepCopy3(obj) {
+    ToolsClass.prototype.deepCopy3 = function (obj) {
         return cloneDeep(obj);
-    }
+    };
     /**
      * 防抖
      * demo：debounce(func, 300)(args)
@@ -57,17 +137,17 @@ class ToolsClass {
      * @param {Number} wait 节流时间,毫秒
      * @return {Function} delay
      */
-    debounce(func, wait) {
-        const delay = function () {
-            const args = arguments;
+    ToolsClass.prototype.debounce = function (func, wait) {
+        var delay = function () {
+            var args = arguments;
             if (timeout)
                 clearTimeout(timeout);
-            timeout = setTimeout(() => {
+            timeout = setTimeout(function () {
                 func.apply(delay, args);
             }, wait);
         };
         return delay;
-    }
+    };
     /**
    * 节流
    * demo：throttle(func, 300)(args)
@@ -75,124 +155,86 @@ class ToolsClass {
    * @param {Number} wait 节流时间,毫秒
    * @return {Function} delay
    */
-    throttle(func, wait) {
-        const delay = function () {
-            const now = Date.now();
+    ToolsClass.prototype.throttle = function (func, wait) {
+        var delay = function () {
+            var now = Date.now();
             if (now - previous > wait) {
                 func.apply(delay, arguments);
                 previous = now;
             }
         };
         return delay;
-    }
+    };
     /**
      * 获取路径中文件名称
      * @param {String} url
      * @return {String}
      */
-    getUrlName(url) {
+    ToolsClass.prototype.getUrlName = function (url) {
         return (url && url.split('?')[0].split('/').reverse()[0]);
-    }
+    };
     /**
      * 动态加载脚本
      * tip：按需加载时用（多次调用，js不会重复加载）
      * @param {String} url
      * @return {Promise}
      */
-    loadJs(url) {
+    ToolsClass.prototype.loadJs = function (url) {
+        var _this = this;
         if (!(window && window.document)) {
             return new Error('仅支持浏览器');
         }
-        const name = this.getUrlName(url);
-        const id = 'js_' + name;
-        return new Promise((resolve, reject) => {
-            if (this.__loaded__[id]) {
+        var name = this.getUrlName(url);
+        var id = 'js_' + name;
+        return new Promise(function (resolve, reject) {
+            if (_this.__loaded__[id]) {
                 return resolve();
             }
-            const script = document.createElement('script');
+            var script = document.createElement('script');
             script.type = 'text/javascript';
             script.async = true;
             script.src = url;
             script.id = id;
-            script.onload = () => {
-                this.__loaded__[id] = true;
+            script.onload = function () {
+                _this.__loaded__[id] = true;
                 resolve();
             };
-            script.onerror = (e) => {
+            script.onerror = function (e) {
                 reject(e);
             };
             document.body.appendChild(script);
         });
-    }
+    };
     /**
      * 动态加载样式
      * @param {String} url
      * @return {Promise}
      */
-    loadCss(url) {
+    ToolsClass.prototype.loadCss = function (url) {
+        var _this = this;
         if (!(window && window.document)) {
             return new Error('仅支持浏览器');
         }
-        const name = this.getUrlName(url);
-        const id = 'css_' + name;
-        return new Promise((resolve, reject) => {
-            if (this.__loaded__[id]) {
+        var name = this.getUrlName(url);
+        var id = 'css_' + name;
+        return new Promise(function (resolve, reject) {
+            if (_this.__loaded__[id]) {
                 return resolve();
             }
-            const link = document.createElement('link');
+            var link = document.createElement('link');
             link.type = 'text/css';
             link.rel = 'stylesheet';
             link.href = url;
             link.id = id;
-            link.onload = () => {
-                this.__loaded__[id] = true;
+            link.onload = function () {
+                _this.__loaded__[id] = true;
                 resolve();
             };
-            link.onerror = (e) => {
+            link.onerror = function (e) {
                 reject(e);
             };
             document.head.appendChild(link);
         });
-    }
-    /**
-     * 蒙层显示后，html禁止滚动操作
-     * @param {String} className
-     * @return {Void}
-     */
-    stopScroll = (className) => {
-        if (!(window && window.document)) {
-            return new Error('仅支持浏览器');
-        }
-        const html = document.documentElement;
-        html.style.overflow = 'hidden';
-        html.style.height = '100%';
-        const body = document.body;
-        body.style.overflow = 'hidden';
-        body.style.height = '100%';
-        if (className) {
-            const dom = document.querySelector(`.${className}`);
-            dom && dom.addEventListener('touchmove', this.__setDefault__);
-        }
-    };
-    /**
-     * 蒙层隐藏后，html开启滚动操作
-     * @param {String} className
-     * @return {Void}
-     */
-    startScroll = (className) => {
-        if (!(window && window.document)) {
-            return new Error('仅支持浏览器');
-        }
-        const html = document.documentElement;
-        html.style.overflow = 'visible';
-        html.style.height = 'auto';
-        const body = document.body;
-        body.style.overflow = 'visible';
-        body.style.height = 'auto';
-        if (className) {
-            const dom = document.querySelector(`.${className}`);
-            dom && dom.removeEventListener('touchmove', this.__setDefault__);
-        }
     };
     /**
      * 字符串复制到剪贴板
@@ -200,91 +242,58 @@ class ToolsClass {
      * @param {String} str
      * @return {String}
      */
-    clipboard(str) {
+    ToolsClass.prototype.clipboard = function (str) {
         if (!(window && window.document)) {
             return new Error('仅支持浏览器');
         }
         return copy(str);
-    }
+    };
     /**
      * 首字母大写
      * @param {String} str
      * @return {String}
      */
-    firstUpperCase(str) {
+    ToolsClass.prototype.firstUpperCase = function (str) {
         return str.charAt(0).toUpperCase() + str.toString().slice(1);
-    }
+    };
     /**
      * 截取数组或字符串，示例：slice('1234', 3)
      * @param {Array|String} target 数组或字符串
      * @param {Number} length 截取长度，从0开始
      * @return {any}
      */
-    slice(target = '', length = 0) {
+    ToolsClass.prototype.slice = function (target, length) {
+        if (target === void 0) { target = ''; }
+        if (length === void 0) { length = 0; }
         return target.slice(0, length);
-    }
+    };
     /**
      * 获取guid
      * @return {String}
      */
-    guid() {
+    ToolsClass.prototype.guid = function () {
         function S4() {
             return (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
         }
         return (S4() + S4() + "-" + S4() + "-" + S4() + "-" + S4() + "-" + S4() + S4() + S4());
-    }
+    };
     /**
      * 获取文本字节数（含中文）
      * @param {String} str
      * @return {String}
      */
-    getBytesOfText(str = '') {
+    ToolsClass.prototype.getBytesOfText = function (str) {
+        if (str === void 0) { str = ''; }
         return str.replace(/[^\u0000-\u00ff]/g, "aa").length;
-    }
-    /**
-   * object 对象转 array 数组
-   * demo:
-   *  objectToArray({a:1,b:2})  输出：["a=1", "b=2"]
-   * @param {Object} obj
-   * @returns {Array} arr
-   */
-    objectToArray = (obj) => {
-        var arr = [];
-        if (typeof obj === 'object') {
-            for (var key in obj) {
-                if (obj.hasOwnProperty(key)) {
-                    arr.push([key, obj[key]].join('='));
-                }
-            }
-        }
-        return arr;
-    };
-    /**
-    * convertEnum
-    * 枚举键值互换
-    * @param {Object} obj
-    * convertKeyValueEnum({a: 1, b: 2}) // {1: "a", 2: "b"}
-    * @returns {Object} result
-    */
-    convertKeyValueEnum = (obj) => {
-        const result = {};
-        if (typeof obj === 'object') {
-            for (const key in obj) {
-                if (obj.hasOwnProperty(key)) {
-                    result[obj[key]] = key;
-                }
-            }
-        }
-        return result;
     };
     /**
     * 数组去重
     * @param {Array} arr
     * @returns {Array}
     */
-    uniqueArr(arr) {
+    ToolsClass.prototype.uniqueArr = function (arr) {
         return Array.from(new Set(arr));
-    }
+    };
     /**
     * 数组元素交换位置
     * index1和index2分别是两个数组的索引值，即是两个要交换元素位置的索引值，如1，5就是数组中下标为1和5的两个元素交换位置
@@ -294,37 +303,38 @@ class ToolsClass {
     * swapArray([1, 2, 3, 4], 2, 3)  // [1, 2, 4, 3]
     * @returns {Array<string | number>} array
     */
-    swapArray(array, index1, index2) {
-        [array[index1], array[index2]] = [array[index2], array[index1]];
+    ToolsClass.prototype.swapArray = function (array, index1, index2) {
+        var _a;
+        _a = [array[index2], array[index1]], array[index1] = _a[0], array[index2] = _a[1];
         return array;
-    }
+    };
     /**
      * 过滤表情符号
      * @param {String} str
      * @return {String}
      */
-    filterEmoji(str) {
+    ToolsClass.prototype.filterEmoji = function (str) {
         return str.replace(/\uD83C[\uDF00-\uDFFF]|\uD83D[\uDC00-\uDE4F]/mg, '');
-    }
+    };
     /**
      * 是否包含表情
      * @param {String} str
      * @return {boolean}
      */
-    containsEmoji(str) {
-        const reg = /\uD83C[\uDF00-\uDFFF]|\uD83D[\uDC00-\uDE4F]/mg;
+    ToolsClass.prototype.containsEmoji = function (str) {
+        var reg = /\uD83C[\uDF00-\uDFFF]|\uD83D[\uDC00-\uDE4F]/mg;
         return reg.test(str);
-    }
+    };
     /**
      * 是否包含表汉字
      * @param {String} str
      * @return {boolean}
      */
-    containsHanZi(str) {
-        const reg = /[\u4e00-\u9fa5]/mg;
+    ToolsClass.prototype.containsHanZi = function (str) {
+        var reg = /[\u4e00-\u9fa5]/mg;
         return reg.test(str);
-    }
-    isEmpty(val) {
+    };
+    ToolsClass.prototype.isEmpty = function (val) {
         // null or undefined
         if (val == null)
             return true;
@@ -351,11 +361,8 @@ class ToolsClass {
             }
         }
         return false;
-    }
-    ;
-    isDefined = (val) => {
-        return val !== undefined && val !== null;
     };
+    ;
     /**
     * 字段脱敏处理
     * @param {String} field 未脱敏字段
@@ -363,20 +370,23 @@ class ToolsClass {
     * @param {Int} after 结尾未脱敏字符数
     * @return {String} 已脱敏字段
     */
-    sensitiveField(field, before = 3, after = 4) {
+    ToolsClass.prototype.sensitiveField = function (field, before, after) {
+        if (before === void 0) { before = 3; }
+        if (after === void 0) { after = 4; }
         if (!field) {
             return '';
         }
         field = String(field);
-        let sensitiveLen = field.length - before - after;
+        var sensitiveLen = field.length - before - after;
         if (sensitiveLen < 0) {
             sensitiveLen = 0;
         }
         // 匹配中文、英文、数字
-        const regItem = '[\u4e00-\u9fa5a-zA-Z0-9]';
-        const regExp = `(${regItem}{${before}})${regItem}*(${regItem}{${after}})`;
-        const reg = new RegExp(regExp);
-        return field.replace(reg, `$1${"*".repeat(sensitiveLen)}$2`);
-    }
-}
+        var regItem = '[\u4e00-\u9fa5a-zA-Z0-9]';
+        var regExp = "(".concat(regItem, "{").concat(before, "})").concat(regItem, "*(").concat(regItem, "{").concat(after, "})");
+        var reg = new RegExp(regExp);
+        return field.replace(reg, "$1".concat("*".repeat(sensitiveLen), "$2"));
+    };
+    return ToolsClass;
+}());
 export default new ToolsClass();

package/dist/modules/track/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Track 埋点模块
+ * 统一封装各项目的埋点上报逻辑
+ *
+ * @example
+ * // 最简初始化（所有配置都有默认值）
+ * import { createTracker } from '@haluo/util/dist/modules/track'
+ *
+ * const tracker = createTracker({})
+ * // 或指定 appName
+ * const tracker2 = createTracker({ appName: 'emoto' })
+ *
+ * // 使用
+ * tracker.track('EVENT_ID', { key: 'value' })
+ * tracker.trackError({ err: 'error message' })
+ */
+import type { TrackConfig, ErrorContent } from './types';
+export * from './types';
+/**
+ * 内置的 getChannel 方法
+ * 根据 UA 检测渠道：微信、QQ、微博等
+ */
+declare function defaultGetChannel(): string;
+/**
+ * Track 类
+ * 提供埋点上报功能
+ */
+declare class Tracker {
+    private config;
+    constructor(config: TrackConfig);
+    /**
+     * 获取当前版本号
+     * 优先级：window.AppCall.getAppVersion() > 传入的 appCall > config.version
+     */
+    private getVersion;
+    /**
+     * 获取渠道号
+     * 优先使用自定义 getChannel，否则使用内置的默认方法
+     */
+    private getChannel;
+    /**
+     * 检查是否命中AB测试
+     */
+    private checkAbTest;
+    /**
+     * 构建埋点请求数据
+     */
+    private buildPostData;
+    /**
+     * 发送埋点请求
+     */
+    private sendRequest;
+    /**
+     * 核心埋点方法
+     * @param params 埋点参数
+     */
+    private trackUser;
+    /**
+     * 埋点上报
+     * @param eId 事件ID
+     * @param contentObj 事件内容对象
+     * @param isAbTest 是否AB测试（已废弃，保留兼容）
+     */
+    track(eId: string, contentObj?: Record<string, any>, isAbTest?: boolean): Promise<any>;
+    /**
+     * 错误上报
+     * @param contentObj 错误内容对象
+     */
+    trackError(contentObj?: Partial<ErrorContent>): Promise<any>;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<TrackConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): TrackConfig;
+}
+/**
+ * 创建 Tracker 实例
+ * @param config 配置项
+ * @returns Tracker 实例
+ *
+ * @example
+ * const tracker = createTracker({
+ *   appName: 'emoto'
+ *   // logUrl 可选，默认: https://log-center.58moto.com/am/log/v1/json
+ *   // httpClient 可选，默认使用内置 fetch 实现
+ * })
+ *
+ * // 普通埋点
+ * tracker.track('EVENT_001', { page: 'home' })
+ *
+ * // 错误上报
+ * tracker.trackError({ err: 'Something went wrong' })
+ */
+export declare function createTracker(config: TrackConfig): Tracker;
+/**
+ * 创建简化版埋点方法
+ * 返回 postTrack 和 postTrackError 方法，与原有项目用法一致
+ *
+ * @example
+ * const { postTrack, postTrackError } = createTrackMethods({
+ *   appName: 'moto'
+ * })
+ *
+ * // 等同于原来的 postJddTrack
+ * postTrack('EVENT_001', { page: 'home' })
+ *
+ * // 等同于原来的 postJddTrackError
+ * postTrackError({ err: 'error message' })
+ */
+export declare function createTrackMethods(config: TrackConfig): {
+    /** 埋点上报方法 */
+    postTrack: (eId: string, contentObj?: Record<string, any>, isAbTest?: boolean) => Promise<any>;
+    /** 错误上报方法 */
+    postTrackError: (contentObj?: Partial<ErrorContent>) => Promise<any>;
+    /** Tracker 实例 */
+    tracker: Tracker;
+};
+export { defaultGetChannel as getChannel };
+export default createTracker;