☰

WhiteSevsUtils

一个好用的工具类

当前为 2023-07-01 提交的版本，查看 最新版本。

此脚本不应直接安装。它是供其他脚本使用的外部库，要使用该库请加入元指令 // @require https://update.gf.qytechs.cn/scripts/455186/1213972/WhiteSevsUtils.js 

  1. /**
  2.  * 方便好用的工具类
  3.  * @copyright GPL-3.0-only
  4.  * @author WhiteSev
  5.  **/
  6. (function () {
  7.   /* 在window下挂载的对象名 */
  8.   const GLOBAL_NAME_SPACE = "Utils";
  9.   const tempUtils =
  10.     typeof window[GLOBAL_NAME_SPACE] !== "undefined"
  11.       ? window[GLOBAL_NAME_SPACE]
  12.       : null;
  13.  
  14.   const Utils = {
  15.     /**
  16.      * 工具类的版本
  17.      * @type {string}
  18.      */
  19.     version: "4.0",
  20.   };
  21.  
  22.   /**
  23.    * JSON数据从源端替换到目标端中，如果目标端存在该数据则替换，不添加，返回结果为目标端替换完毕的结果
  24.    * @param {object} target	目标端
  25.    * @param {object} source	源端
  26.    * @returns {object}
  27.    * @example
  28.    * Utils.assign({"1":1,"2":{"3":3}}, {"2":{"3":4}});
  29.    * > {
  30.             "1": 1,
  31.             "2": {
  32.                 "3": 4
  33.             }
  34.         }
  35.    **/
  36.   Utils.assign = function (target = {}, source = {}) {
  37.     for (let targetKeyName in target) {
  38.       let targetValue = target[targetKeyName];
  39.       if (targetKeyName in source) {
  40.         let sourceValue = source[targetKeyName];
  41.         if (typeof sourceValue === "object" && !Utils.isDOM(sourceValue)) {
  42.           /* 源端的值是object类型，且不是元素对象 */
  43.           target[targetKeyName] = Utils.assign(targetValue, sourceValue);
  44.         } else {
  45.           /* 直接赋值 */
  46.           target[targetKeyName] = sourceValue;
  47.         }
  48.       }
  49.     }
  50.     return target;
  51.   };
  52.  
  53.   /**
  54.    * 【手机】检测点击的地方是否在该元素区域内
  55.    * @param {HTMLElement|Node} obj	需要检测的元素
  56.    * @returns {boolean}
  57.    * + true 点击在元素上
  58.    * + false 未点击在元素上
  59.    * @example
  60.    * Utils.checkUserClickInNode(document.querySelector(".xxx"));
  61.    * > false
  62.    **/
  63.   Utils.checkUserClickInNode = function (targetNode) {
  64.     if (!Utils.isDOM(targetNode)) {
  65.       throw new Error(
  66.         "Utils.checkUserClickInNode 参数 targetNode 必须为 HTMLElement|Node 类型"
  67.       );
  68.     }
  69.     let mouseClickPosX = Number(window.event.clientX); /* 鼠标相对屏幕横坐标 */
  70.     let mouseClickPosY = Number(window.event.clientY); /* 鼠标相对屏幕纵坐标 */
  71.     let elementPosXLeft = Number(
  72.       targetNode.getBoundingClientRect().left
  73.     ); /* 要检测的元素的相对屏幕的横坐标最左边 */
  74.     let elementPosXRight = Number(
  75.       targetNode.getBoundingClientRect().right
  76.     ); /* 要检测的元素的相对屏幕的横坐标最右边 */
  77.     let elementPosYTop = Number(
  78.       targetNode.getBoundingClientRect().top
  79.     ); /* 要检测的元素的相对屏幕的纵坐标最上边 */
  80.     let elementPosYBottom = Number(
  81.       targetNode.getBoundingClientRect().bottom
  82.     ); /* 要检测的元素的相对屏幕的纵坐标最下边 */
  83.     if (
  84.       mouseClickPosX >= elementPosXLeft &&
  85.       mouseClickPosX <= elementPosXRight &&
  86.       mouseClickPosY >= elementPosYTop &&
  87.       mouseClickPosY <= elementPosYBottom
  88.     ) {
  89.       return true;
  90.     } else if (
  91.       window.event.target &&
  92.       typeof window.event.target.innerHTML === "string" &&
  93.       window.event.target.innerHTML.indexOf(targetNode.innerHTML) !== -1
  94.     ) {
  95.       /* 这种情况是应对在界面中隐藏的元素，getBoundingClientRect获取的都是0 */
  96.       return true;
  97.     } else {
  98.       return false;
  99.     }
  100.   };
  101.  
  102.   /**
  103.    * 删除某个父元素，父元素可能在上层或上上层或上上上层...
  104.    * @param {HTMLElement|Node} target	当前元素
  105.    * @param {string} targetSelector	判断是否满足父元素，参数为当前处理的父元素，满足返回true，否则false
  106.    * @returns {boolean}
  107.    * + true 已删除
  108.    * + false 未删除
  109.    * @example
  110.    * Utils.deleteParentNode(document.querySelector("a"),".xxx");
  111.    * > true
  112.    **/
  113.   Utils.deleteParentNode = function (target, targetSelector) {
  114.     if (target == null) {
  115.       throw new Error("Utils.deleteParentNode 参数 target 不能为 null");
  116.     }
  117.     if (!Utils.isDOM(target)) {
  118.       throw new Error(
  119.         "Utils.deleteParentNode 参数 target 必须为 Node|HTMLElement 类型"
  120.       );
  121.     }
  122.     if (typeof targetSelector !== "string") {
  123.       throw new Error(
  124.         "Utils.deleteParentNode 参数 targetSelector 必须为 string 类型"
  125.       );
  126.     }
  127.     let result = false;
  128.     let needRemoveDOM = target.closest(targetSelector);
  129.     if (needRemoveDOM) {
  130.       needRemoveDOM.remove();
  131.       result = true;
  132.     }
  133.     return result;
  134.   };
  135.  
  136.   /**
  137.    * 字典
  138.    * @example
  139.    * let dictionary = new Utils.Dictionary();
  140.    * let dictionary2 = new Utils.Dictionary();
  141.    * dictionary.set("test","111");
  142.    * dictionary.get("test");
  143.    * > '111'
  144.    * dictionary.has("test");
  145.    * > true
  146.    * dictionary.concat(dictionary2);
  147.    **/
  148.   Utils.Dictionary = function () {
  149.     this.items = {};
  150.     /**
  151.      * 检查是否有某一个键
  152.      * @param {*} key 键
  153.      * @returns {boolean}
  154.      */
  155.     this.has = function (key) {
  156.       return this.items.hasOwnProperty(key);
  157.     };
  158.     /**
  159.      * 为字典添加某一个值
  160.      * @param {*} key 键
  161.      * @param {*} val 值，默认为""
  162.      */
  163.     this.set = function (key, val = "") {
  164.       if (key === undefined) {
  165.         throw new Error("Utils.Dictionary().set 参数 key 不能为空");
  166.       }
  167.       this.items[key] = val;
  168.     };
  169.     /**
  170.      * 删除某一个键
  171.      * @param {*} key 键
  172.      * @returns {boolean}
  173.      */
  174.     this.delete = function (key) {
  175.       if (this.has(key)) {
  176.         delete this.items[key];
  177.         return true;
  178.       }
  179.       return false;
  180.     };
  181.     /**
  182.      * 获取某个键的值
  183.      * @param {*} key 键
  184.      * @returns {any|undefined}
  185.      */
  186.     this.get = function (key) {
  187.       return this.has(key) ? this.items[key] : undefined;
  188.     };
  189.     /**
  190.      * 返回字典中的所有值
  191.      * @returns {array}
  192.      */
  193.     this.values = function () {
  194.       let resultList = [];
  195.       for (let prop in this.items) {
  196.         if (this.has(prop)) {
  197.           resultList.push(this.items[prop]);
  198.         }
  199.       }
  200.       return resultList;
  201.     };
  202.     /**
  203.      * 清空字典
  204.      */
  205.     this.clear = function () {
  206.       this.items = {};
  207.     };
  208.     /**
  209.      * 获取字典的长度
  210.      * @returns {number}
  211.      */
  212.     this.size = function () {
  213.       return Object.keys(this.items).length;
  214.     };
  215.     /**
  216.      * 获取字典所有的键
  217.      * @returns
  218.      */
  219.     this.keys = function () {
  220.       return Object.keys(this.items);
  221.     };
  222.     /**
  223.      * 返回字典本身
  224.      * @returns
  225.      */
  226.     this.getItems = function () {
  227.       return this.items;
  228.     };
  229.     /**
  230.      * 合并另一个字典
  231.      * @param {Dictionary} data 需要合并的字典
  232.      */
  233.     this.concat = function (data) {
  234.       this.items = Utils.assign(this.items, data.getItems());
  235.     };
  236.   };
  237.  
  238.   /**
  239.    * 主动触发事件
  240.    * @param {HTMLElement} dom 元素
  241.    * @param {string|[...string]} eventName 事件名称，可以是字符串，也可是字符串格式的列表
  242.    * @example
  243.    * Utils.dispatchEvent(document.querySelector("input","input"))
  244.    */
  245.   Utils.dispatchEvent = function (dom, eventName) {
  246.     let eventNameList = [];
  247.     if (typeof eventName === "string") {
  248.       eventNameList = [eventName];
  249.     }
  250.     if (Array.isArray(eventName)) {
  251.       eventNameList = [...eventName];
  252.     }
  253.     eventNameList.forEach((_eventName_) => {
  254.       dom.dispatchEvent(new Event(_eventName_));
  255.     });
  256.   };
  257.  
  258.   /**
  259.    * 下载base64格式的数据
  260.    * @param {string} base64Data	需要转换的base64数据
  261.    * @param {string} fileName	需要保存的文件名
  262.    * @example
  263.    * Utils.downloadBase64("data:image/jpeg:base64/,xxxxxx");
  264.    **/
  265.   Utils.downloadBase64 = function (base64Data, fileName) {
  266.     if (typeof base64Data !== "string") {
  267.       throw new Error(
  268.         "Utils.downloadBase64 参数 base64Data 必须为 string 类型"
  269.       );
  270.     }
  271.     if (typeof fileName !== "string") {
  272.       throw new Error("Utils.downloadBase64 参数 fileName 必须为 string 类型");
  273.     }
  274.     let aLink = document.createElement("a");
  275.     aLink.download = fileName;
  276.     aLink.href = base64Data;
  277.     aLink.click();
  278.   };
  279.  
  280.   /**
  281.    * 定位网页中可见字符串的位置定位并高亮
  282.    * @param {string} str	需要寻找的字符串
  283.    * @param {boolean} caseSensitive
  284.    * + true 区分大小写
  285.    * + false (默认) 不区分大小写
  286.    * @return {boolean}
  287.    * + true 找到
  288.    * + false 未找到
  289.    * @example
  290.    * Utils.findVisibleText("xxxxx");
  291.    * > true
  292.    **/
  293.   Utils.findVisibleText = function (str = "", caseSensitive = false) {
  294.     let TRange = null;
  295.     let strFound;
  296.     if (window.find) {
  297.       /* CODE FOR BROWSERS THAT SUPPORT window.find */
  298.       strFound = self.find(str, caseSensitive, true, true, false);
  299.       if (strFound && self.getSelection && !self.getSelection().anchorNode) {
  300.         strFound = self.find(str, caseSensitive, true, true, false);
  301.       }
  302.       if (!strFound) {
  303.         strFound = self.find(str, 0, 1);
  304.         while (self.find(str, 0, 1)) continue;
  305.       }
  306.     } else if (navigator.appName.indexOf("Microsoft") != -1) {
  307.       /* EXPLORER-SPECIFIC CODE */
  308.       if (TRange != null) {
  309.         TRange.collapse(false);
  310.         strFound = TRange.findText(str);
  311.         if (strFound) TRange.select();
  312.       }
  313.       if (TRange == null || strFound == 0) {
  314.         TRange = self.document.body.createTextRange();
  315.         strFound = TRange.findText(str);
  316.         if (strFound) TRange.select();
  317.       }
  318.     } else if (navigator.appName == "Opera") {
  319.       alert("Opera browsers not supported, sorry...");
  320.       return;
  321.     }
  322.     return strFound ? true : false;
  323.   };
  324.  
  325.   /**
  326.    * 格式化byte为KB、MB、GB、TB、PB、EB、ZB、YB、BB、NB、DB
  327.    * @param {number} bitSize 字节
  328.    * @param {boolean} addType
  329.    * + true (默认) 添加单位
  330.    * + false 不添加单位
  331.    * @returns {string|number}
  332.    * + {string} 当addType为true时，且保留小数点末尾2位
  333.    * + {number} 当addType为false时，且保留小数点末尾2位
  334.    * @example
  335.    * Utils.formatByteToSize("812304");
  336.    * > '793.27KB'
  337.    * @example
  338.    * Utils.formatByteToSize("812304",false);
  339.    * > 793.27
  340.    **/
  341.   Utils.formatByteToSize = function (byteSize, addType = true) {
  342.     byteSize = parseInt(byteSize);
  343.     if (isNaN(byteSize)) {
  344.       throw new Error("Utils.formatByteToSize 参数 byteSize 格式不正确");
  345.     }
  346.     let result = 0;
  347.     let resultType = "KB";
  348.     let sizeData = {};
  349.     sizeData.B = 1;
  350.     sizeData.KB = 1024;
  351.     sizeData.MB = sizeData.KB * sizeData.KB;
  352.     sizeData.GB = sizeData.MB * sizeData.KB;
  353.     sizeData.TB = sizeData.GB * sizeData.KB;
  354.     sizeData.PB = sizeData.TB * sizeData.KB;
  355.     sizeData.EB = sizeData.PB * sizeData.KB;
  356.     sizeData.ZB = sizeData.EB * sizeData.KB;
  357.     sizeData.YB = sizeData.ZB * sizeData.KB;
  358.     sizeData.BB = sizeData.YB * sizeData.KB;
  359.     sizeData.NB = sizeData.BB * sizeData.KB;
  360.     sizeData.DB = sizeData.NB * sizeData.KB;
  361.     for (key in sizeData) {
  362.       result = byteSize / sizeData[key];
  363.       resultType = key;
  364.       if (sizeData.KB >= result) {
  365.         break;
  366.       }
  367.     }
  368.     result = result.toFixed(2);
  369.     result = addType ? result + resultType.toString() : parseFloat(result);
  370.     return result;
  371.   };
  372.  
  373.   /**
  374.    * 应用场景: 当你想要获取数组形式的元素时，它可能是其它的选择器，那么需要按照先后顺序填入参数
  375.    * 第一个是优先级最高的，依次下降，如果都没有，返回空列表
  376.    * 支持document.querySelectorAll、$("")、()=>{return document.querySelectorAll("")}
  377.    * @param {...NodeList|Function} NodeList
  378.    * @returns {...HTMLElement}
  379.    * @example
  380.    * Utils.getNodeListValue(document.querySelectorAll("div.xxx"),document.querySelectorAll("a.xxx"));
  381.    * > [...div,div,div]
  382.    * @example
  383.    * Utils.getNodeListValue(divGetFunction,aGetFunction);
  384.    * > [...div,div,div]
  385.    */
  386.   Utils.getNodeListValue = function () {
  387.     let resultArray = [];
  388.     for (let i = 0; i < arguments.length; i++) {
  389.       let item = arguments[i];
  390.       let value = item;
  391.       if (typeof item === "function") {
  392.         /* 方法 */
  393.         value = item();
  394.       }
  395.       if (value.length !== 0) {
  396.         resultArray = [...value];
  397.         break;
  398.       }
  399.     }
  400.     return resultArray;
  401.   };
  402.   /**
  403.    * 获取格式化后的时间
  404.    * @param {string|undefined} text	需要格式化的字符串或者时间戳
  405.    * @param {string|undefined} formatType	格式化成的显示类型
  406.    * + yyyy 年
  407.    * + MM 月
  408.    * + dd 天
  409.    * + HH 时 (24小时制)
  410.    * + hh 时 (12小时制)
  411.    * + mm 分
  412.    * + ss 秒
  413.    * @returns {string}	返回格式化后的时间
  414.    * @example
  415.    * Utils.formatTime("2022-08-21 23:59:00","HH:mm:ss");
  416.    * > '23:59:00'
  417.    * @example
  418.    * Utils.formatTime(1899187424988,"HH:mm:ss");
  419.    * > '15:10:13'
  420.    * @example
  421.    * Utils.formatTime()
  422.    * > '2023-1-1 00:00:00'
  423.    **/
  424.   Utils.formatTime = function (text, formatType = "yyyy-MM-dd HH:mm:ss") {
  425.     if (text != null && typeof text !== "string" && typeof text !== "number") {
  426.       throw new Error("Utils.formatTime 参数 text 必须为 string|number 类型");
  427.     }
  428.     if (typeof formatType !== "string") {
  429.       throw new Error("Utils.formatTime 参数 formatType 必须为 string 类型");
  430.     }
  431.     let time = text == null ? new Date() : new Date(text);
  432.     /**
  433.      * 校验时间补0
  434.      * @param {number} timeNum
  435.      * @returns
  436.      */
  437.     function checkTime(timeNum) {
  438.       if (timeNum < 10) return "0" + timeNum;
  439.       return timeNum;
  440.     }
  441.  
  442.     /**
  443.      * 时间制修改 24小时制转12小时制
  444.      * @param {number} hourNum 小时
  445.      * @returns
  446.      */
  447.     function timeSystemChange(hourNum) {
  448.       return hourNum > 12 ? hourNum - 12 : hourNum;
  449.     }
  450.  
  451.     let timeRegexp = {
  452.       yyyy: time.getFullYear(),
  453.       /* 年 */
  454.       MM: checkTime(time.getMonth() + 1),
  455.       /* 月 */
  456.       dd: checkTime(time.getDate()),
  457.       /* 日 */
  458.       HH: checkTime(time.getHours()),
  459.       /* 时 (24小时制) */
  460.       hh: checkTime(timeSystemChange(time.getHours())),
  461.       /* 时 (12小时制) */
  462.       mm: checkTime(time.getMinutes()),
  463.       /* 分 */
  464.       ss: checkTime(time.getSeconds()),
  465.       /* 秒 */
  466.     };
  467.     Object.keys(timeRegexp).forEach(function (key) {
  468.       let replaecRegexp = new RegExp(key, "g");
  469.       formatType = formatType.replace(replaecRegexp, timeRegexp[key]);
  470.     });
  471.     return formatType;
  472.   };
  473.  
  474.   /**
  475.    * 字符串格式的时间转时间戳
  476.    * @param {string} text	字符串格式的时间，例如：
  477.    * + 2022-11-21 00:00:00
  478.    * + 00:00:00
  479.    * @return {number} 返回时间戳
  480.    * @example
  481.    * Utils.formatToTimeStamp("2022-11-21 00:00:00");
  482.    * > 1668960000000
  483.    **/
  484.   Utils.formatToTimeStamp = function (text) {
  485.     /* 把字符串格式的时间（完整，包括日期和时间）格式化成时间 */
  486.     if (typeof text !== "string") {
  487.       throw new Error("Utils.formatToTimeStamp 参数 text 必须为 string 类型");
  488.     }
  489.     if (text.length === 8) {
  490.       /* 该字符串只有时分秒 */
  491.       let today = new Date();
  492.       text =
  493.         today.getFullYear() +
  494.         "-" +
  495.         (today.getMonth() + 1) +
  496.         "-" +
  497.         today.getDate() +
  498.         " " +
  499.         text;
  500.     }
  501.     text = text.substring(0, 19);
  502.     text = text.replace(/-/g, "/");
  503.     let timestamp = new Date(text).getTime();
  504.     return timestamp;
  505.   };
  506.  
  507.   /**
  508.    * 自动锁对象，用于循环判断运行的函数，在循环外new后使用，注意，如果函数内部存在异步操作，需要使用await
  509.    * @param {Function|string} func 需要执行的函数
  510.    * @param {Function|undefined} scope 函数作用域
  511.    * @param {number} unLockDelayTime 延迟xx毫秒后解锁，默认0
  512.    * @example
  513.     let lock = new Utils.funcLock(()=>{console.log(1)}))
  514.     lock.run();
  515.     > 1
  516.    * @example
  517.     let lock = new Utils.funcLock(()=>{console.log(1)}),true) -- 异步操作
  518.     await lock.run();
  519.     > 1
  520.    **/
  521.   Utils.funcLock = function (func, scope, unLockDelayTime = 0) {
  522.     let flag = false;
  523.     let that = this;
  524.     scope = scope || this;
  525.     /**
  526.      * 锁
  527.      */
  528.     this.lock = function () {
  529.       flag = true;
  530.     };
  531.     /**
  532.      * 解锁
  533.      */
  534.     this.unlock = function () {
  535.       setTimeout(() => {
  536.         flag = false;
  537.       }, unLockDelayTime);
  538.     };
  539.     /**
  540.      * 执行
  541.      * @param  {...any} funArgs 参数
  542.      * @returns {Promise}
  543.      */
  544.     this.run = async function (...funArgs) {
  545.       if (flag) {
  546.         return;
  547.       }
  548.       that.lock();
  549.       await func.apply(scope, funArgs); /* arguments调用 */
  550.       that.unlock();
  551.     };
  552.   };
  553.  
  554.   /**
  555.    * 获取天数差异，如何获取某个时间与另一个时间相差的天数
  556.    * @param {number} timestamp1 时间戳(毫秒|秒)
  557.    * @param {number} timestamp2 时间戳(毫秒|秒)
  558.    * @param {string} type 返回的数字的表达的类型，比如：年、月、天、时、分、秒，默认天
  559.    * @returns {number}
  560.    * @example
  561.    * Utils.getDaysDifference(new Date().getTime());
  562.    * > 0
  563.    * @example
  564.    * Utils.getDaysDifference(new Date().getTime(),undefined,"秒");
  565.    * > 0
  566.    */
  567.   Utils.getDaysDifference = function (
  568.     timestamp1 = new Date().getTime(),
  569.     timestamp2 = new Date().getTime(),
  570.     type = "天"
  571.   ) {
  572.     type = type.trim();
  573.     if (timestamp1.toString().length === 10) {
  574.       timestamp1 = timestamp1 * 1000;
  575.     }
  576.     if (timestamp2.toString().length === 10) {
  577.       timestamp2 = timestamp2 * 1000;
  578.     }
  579.     let smallTimeStamp = timestamp1 > timestamp2 ? timestamp2 : timestamp1;
  580.     let bigTimeStamp = timestamp1 > timestamp2 ? timestamp1 : timestamp2;
  581.     let oneSecond = 1000; /* 一秒的毫秒数 */
  582.     let oneMinute = 60 * oneSecond; /* 一分钟的毫秒数 */
  583.     let oneHour = 60 * oneMinute; /* 一小时的毫秒数 */
  584.     let oneDay = 24 * oneHour; /* 一天的毫秒数 */
  585.     let oneMonth = 30 * oneDay; /* 一个月的毫秒数(30天) */
  586.     let oneYear = 12 * oneMonth; /* 一年的毫秒数 */
  587.     let bigDate = new Date(bigTimeStamp);
  588.     let smallDate = new Date(smallTimeStamp);
  589.     let remainderValue = 1;
  590.     if (type === "年") {
  591.       remainderValue = oneYear;
  592.     } else if (type === "月") {
  593.       remainderValue = oneMonth;
  594.     } else if (type === "天") {
  595.       remainderValue = oneDay;
  596.     } else if (type === "时") {
  597.       remainderValue = oneHour;
  598.     } else if (type === "分") {
  599.       remainderValue = oneMinute;
  600.     } else if (type === "秒") {
  601.       remainderValue = oneSecond;
  602.     }
  603.     let diffValue = Math.round(
  604.       Math.abs((bigDate - smallDate) / remainderValue)
  605.     );
  606.     return diffValue;
  607.   };
  608.  
  609.   /**
  610.    * 获取页面中最大的z-index再+1
  611.    * @returns {number}
  612.    * @example
  613.    * Utils.getMaxZIndex();
  614.    * > 1001
  615.    **/
  616.   Utils.getMaxZIndex = function () {
  617.     let nodeIndexList = [];
  618.     document.querySelectorAll("*").forEach((element) => {
  619.       let nodeStyle = window.getComputedStyle(element);
  620.       /* 不对position为static和display为none的元素进行获取它们的z-index */
  621.       if (nodeStyle.position !== "static" && nodeStyle.display !== "none") {
  622.         nodeIndexList = nodeIndexList.concat(parseInt(nodeStyle.zIndex));
  623.       }
  624.     });
  625.     nodeIndexList = nodeIndexList.filter(Boolean); /* 过滤非Boolean类型 */
  626.     return nodeIndexList.length ? Math.max(...nodeIndexList) + 1 : 0;
  627.   };
  628.  
  629.   /**
  630.    * 获取随机的安卓手机User-Agent
  631.    * @return {string} 返回随机字符串
  632.    * @example
  633.    * Utils.getRandomAndroidUA();
  634.    * > 'Mozilla/5.0 (Linux; Android 9; MI 13 Build/OPR1.170623.027; wv) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.3490.40 Mobile Safari/537.36'
  635.    **/
  636.   Utils.getRandomAndroidUA = function () {
  637.     let androidVersion = Utils.getRandomNumber(9, 13);
  638.     let mobileNameList = [
  639.       "LDN-LX3",
  640.       "RNE-L03",
  641.       "ASUS_X00ID Build/NMF26F",
  642.       "WAS-LX3",
  643.       "PRA-LX3",
  644.       "MYA-L03",
  645.       "Moto G Play",
  646.       "Moto C Build/NRD90M.063",
  647.       "Redmi Note 4 Build/NRD90M",
  648.       "HUAWEI VNS-L21 Build/HUAWEIVNS-L21",
  649.       "VTR-L09",
  650.       "TRT-LX3",
  651.       "M2003J15SC Build/RP1A.200720.011; wv",
  652.       "MI 13 Build/OPR1.170623.027; wv",
  653.     ];
  654.     let randomMobile = Utils.getRandomArrayValue(mobileNameList);
  655.     let chromeVersion1 = Utils.getRandomNumber(100, 113);
  656.     let chromeVersion2 = Utils.getRandomNumber(2272, 5304);
  657.     let chromeVersion3 = Utils.getRandomNumber(1, 218);
  658.     return `Mozilla/5.0 (Linux; Android ${androidVersion}; ${randomMobile}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${chromeVersion1}.0.${chromeVersion2}.${chromeVersion3} Mobile Safari/537.36`;
  659.   };
  660.  
  661.   /**
  662.    * 获取数组的随机值
  663.    * @param {...any} array 数组数据
  664.    * @returns {any}	返回数组的随机值
  665.    * @example
  666.    * Utils.getRandomArrayValue(["工具类","getRandomArrayValue"]);
  667.    * > 'getRandomArrayValue'
  668.    **/
  669.   Utils.getRandomArrayValue = function (array) {
  670.     return array[Math.floor(Math.random() * array.length)];
  671.   };
  672.  
  673.   /**
  674.    * 获取两个数字区间的随机值
  675.    * @param {number} number 数字区间
  676.    * @param {number} number2 数字区间
  677.    * @returns {number} 返回两个数字区间的随机值
  678.    * @example
  679.    * Utils.getRandomNumber(1,10);
  680.    * > 5
  681.    * @example
  682.    * Utils.getRandomNumber(10,1);
  683.    * > 8
  684.    **/
  685.   Utils.getRandomNumber = function (number, number2) {
  686.     if (typeof number !== "number") {
  687.       throw new Error("Utils.getRandNumber 参数 number 必须为 number 类型");
  688.     }
  689.     if (typeof number2 !== "number") {
  690.       throw new Error("Utils.getRandNumber 参数 number2 必须为 number 类型");
  691.     }
  692.     let leftNumber = number > number2 ? number2 : number;
  693.     let rightNumber = number > number2 ? number : number2;
  694.     return Math.round(Math.random() * (rightNumber - leftNumber)) + leftNumber;
  695.   };
  696.  
  697.   /**
  698.    * 获取随机的电脑端User-Agent
  699.    * @return {string} 返回随机字符串
  700.    * @example
  701.    * Utils.getRandomPCUA();
  702.    * > 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.5068.19 Safari/537.36'
  703.    **/
  704.   Utils.getRandomPCUA = function () {
  705.     let chromeVersion1 = Utils.getRandomNumber(100, 113);
  706.     let chromeVersion2 = Utils.getRandomNumber(2272, 5304);
  707.     let chromeVersion3 = Utils.getRandomNumber(1, 218);
  708.     return `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${chromeVersion1}.0.${chromeVersion2}.${chromeVersion3} Safari/537.36`;
  709.   };
  710.  
  711.   /**
  712.    * 获取元素上的使用React框架的实例属性，目前包括reactFiber、reactProps、reactEvents、reactEventHandlers、reactInternalInstance
  713.    * @param {HTMLElement} dom 需要获取的目标元素
  714.    * @returns {object}
  715.    * @example
  716.    * Utils.getReactObj(document.querySelector("input"))?.reactProps?.onChange({target:{value:"123"}});
  717.    */
  718.   Utils.getReactObj = function (dom) {
  719.     let result = {};
  720.     Object.keys(dom).forEach((domPropsName) => {
  721.       if (domPropsName.startsWith("__react")) {
  722.         let propsName = domPropsName.replace(/__(.+)\$.+/i, "$1");
  723.         if (propsName in result) {
  724.           new Error("重复属性 " + domPropsName);
  725.         } else {
  726.           result[propsName] = dom[domPropsName];
  727.         }
  728.       }
  729.     });
  730.     return result;
  731.   };
  732.  
  733.   /**
  734.    * 获取文本的字符长度
  735.    * @param {string} text
  736.    * @returns {number}
  737.    * @example
  738.    * Utils.getTextLength("测试文本")
  739.    * > 12
  740.    */
  741.   Utils.getTextLength = function (text) {
  742.     let encoder = new TextEncoder();
  743.     let bytes = encoder.encode(text);
  744.     return bytes.length;
  745.   };
  746.  
  747.   /**
  748.    * 获取文本占据的空间大小，返回自动的单位，如12 Kb,14 K,20 MB，1 GB
  749.    * @param {string} text 目标字符串
  750.    * @param {boolean} addType
  751.    * + true (默认) 自动添加单位
  752.    * + false 不添加单位
  753.    * @returns {string}
  754.    * @example
  755.    * Utils.getTextStorageSize("测试文本");
  756.    * > '12.00B'
  757.    */
  758.   Utils.getTextStorageSize = function (text, addType = true) {
  759.     return Utils.formatByteToSize(Utils.getTextLength(text), addType);
  760.   };
  761.  
  762.   /**
  763.    * 在页面中增加style元素，如果html节点存在子节点，添加子节点第一个，反之，添加到html节点的子节点最后一个
  764.    * @param {string} cssText css字符串
  765.    * @returns {HTMLElement} 返回添加的CSS标签
  766.    * @example
  767.    * Utils.GM_addStyle("html{}");
  768.    * > <style type="text/css">html{}</style>
  769.    */
  770.   Utils.GM_addStyle = function (cssText) {
  771.     if (typeof cssText !== "string") {
  772.       throw new Error("Utils.GM_addStyle 参数cssText 必须为String类型");
  773.     }
  774.     let cssNode = document.createElement("style");
  775.     cssNode.setAttribute("type", "text/css");
  776.     cssNode.innerHTML = cssText;
  777.     if (document.documentElement.childNodes.length === 0) {
  778.       /* 插入body后 */
  779.       document.documentElement.appendChild(cssNode);
  780.     } else {
  781.       /* 插入head前面 */
  782.       document.documentElement.insertBefore(
  783.         cssNode,
  784.         document.documentElement.childNodes[0]
  785.       );
  786.     }
  787.     return cssNode;
  788.   };
  789.  
  790.   /**
  791.    * 对于GM_cookie的兼容写法，当无法使用GM_cookie时可以使用这个,但是并不完全兼容，有些写不出来且限制了httponly是无法访问的
  792.    * @example
  793.     let GM_cookie = new Utils.GM_Cookie();
  794.     GM_cookie.list({name:"xxx_cookie_xxx"},function(cookies,error){
  795.         if (!error) {
  796.             console.log(cookies);
  797.             console.log(cookies.value);
  798.         } else {
  799.             console.error(error);
  800.         }
  801.     });
  802.     GM_cookie.set({name:"xxx_cookie_test_xxx",value:"这是Cookie测试值"},function(error){
  803.         if (error) {
  804.             console.error(error);
  805.         } else {
  806.             console.log('Cookie set successfully.');
  807.         }
  808.     })
  809.     GM_cookie.delete({name:"xxx_cookie_test_xxx"},function(error){
  810.         if (error) {
  811.             console.error(error);
  812.         } else {
  813.             console.log('Cookie set successfully.');
  814.         }
  815.     })
  816.    **/
  817.   Utils.GM_Cookie = function () {
  818.     /**
  819. 	 * 获取Cookie
  820. 	 * @param {Object} paramDetails 
  821. 		+ url string? 默认为当前的url
  822. 		+ domain string? 默认为当前的域名(window.location.hostname)
  823. 		+ name string? 需要检索的Cookie的名字
  824. 		+ path string? 需要检索的Cookie的路径，默认为"/"
  825. 	* @param {Function} callback 
  826. 		+ cookies object[] 
  827. 		+ error string|undefined
  828. 	*/
  829.     this.list = (paramDetails = {}, callback = () => {}) => {
  830.       let resultData = [];
  831.       try {
  832.         let details = {
  833.           url: window.location.href,
  834.           domain: window.location.hostname,
  835.           name: "",
  836.           path: "/",
  837.         };
  838.         paramDetails = Utils.assign(details, paramDetails);
  839.         let cookies = document.cookie.split(";");
  840.         cookies.forEach((item) => {
  841.           let nameRegexp = new RegExp("^" + paramDetails.name + "=", "g");
  842.           item = item.trimStart();
  843.           if (item.match(nameRegexp)) {
  844.             resultData = [
  845.               ...resultData,
  846.               {
  847.                 domain: window.location.hostname,
  848.                 expirationDate: undefined,
  849.                 hostOnly: true,
  850.                 httpOnly: false,
  851.                 name: item,
  852.                 path: "/",
  853.                 sameSite: "unspecified",
  854.                 secure: true,
  855.                 session: false,
  856.                 value: decodeURIComponent(item.replace(nameRegexp, "")),
  857.               },
  858.             ];
  859.  
  860.             return;
  861.           }
  862.         });
  863.         callback(resultData, undefined);
  864.       } catch (error) {
  865.         callback(resultData, error);
  866.       }
  867.     };
  868.  
  869.     /**
  870.      * 设置Cookie
  871.      * @param {Object} paramDetails
  872.      * @param {Function} callback
  873.      */
  874.     this.set = (paramDetails = {}, callback = () => {}) => {
  875.       try {
  876.         let details = {
  877.           url: window.location.href,
  878.           name: "",
  879.           value: "",
  880.           domain: window.location.hostname,
  881.           path: "/",
  882.           secure: true,
  883.           httpOnly: false,
  884.           expirationDate: Math.floor(Date.now()) + 60 * 60 * 24 * 30, // Expires in 30 days
  885.         };
  886.         paramDetails = Utils.assign(details, paramDetails);
  887.         let life = paramDetails.expirationDate
  888.           ? paramDetails.expirationDate
  889.           : Math.floor(Date.now()) + 60 * 60 * 24 * 30;
  890.         let cookieStr =
  891.           paramDetails.name +
  892.           "=" +
  893.           decodeURIComponent(paramDetails.value) +
  894.           ";expires=" +
  895.           new Date(life).toGMTString();
  896.         document.cookie = cookieStr;
  897.         callback();
  898.       } catch (error) {
  899.         callback(error);
  900.       }
  901.     };
  902.  
  903.     /**
  904.      * 删除Cookie
  905.      * @param {Object} paramDetails
  906.      * @param {Function} callback
  907.      */
  908.     this.delete = (paramDetails = {}, callback = () => {}) => {
  909.       try {
  910.         let details = {
  911.           url: window.location.href,
  912.           name: "",
  913.           firstPartyDomain: "",
  914.         };
  915.         paramDetails = Utils.assign(details, paramDetails);
  916.         let cookieStr =
  917.           paramDetails.name +
  918.           "=" +
  919.           decodeURIComponent("null") +
  920.           ";expires=" +
  921.           new Date().toGMTString();
  922.         document.cookie = cookieStr;
  923.         callback();
  924.       } catch (error) {
  925.         callback(error);
  926.       }
  927.     };
  928.   };
  929.  
  930.   /**
  931.    * 注册(不可用)油猴菜单
  932.    * @param {object} data 传递的菜单数据
  933.    * @param {boolean} autoReload 点击该菜单后数据改变后自动重载页面,
  934.    * + true (默认) 开启点击菜单后自动刷新网页
  935.    * + false 关闭点击菜单后自动刷新网页
  936.    * @param {Function} _GM_getValue_ 传入油猴函数 GM_getValue
  937.    * @param {Function} _GM_setValue_ 传入油猴函数 GM_setValue
  938.    * @param {Function} _GM_registerMenuCommand_ 传入油猴函数 GM_registerMenuCommand
  939.    * @param {Function} _GM_unregisterMenuCommand_ 传入油猴函数 GM_unregisterMenuCommand
  940.    * @example
  941.     let gm_Menu = new Utils.GM_Menu(
  942.       {
  943.         menu_key:{
  944.           text: "测试按钮",
  945.           enable: true,
  946.           showText: (text,enable) =>  {
  947.             return "[" + (enable ? "√" : "×") + "]" + text;
  948.           },
  949.           callback: (key,status)  =>  {
  950.             console.log("点击菜单，值修改为",status);
  951.           }
  952.         }
  953.       },
  954.       true,
  955.       GM_getValue,
  956.       GM_setValue,
  957.       GM_registerMenuCommand,
  958.       GM_unregisterMenuCommand);
  959.  
  960.     // 获取某个菜单项的值
  961.     gm_Menu.get("menu_key");
  962.     > true
  963.  
  964.     // 添加键为menu_key2的菜单项
  965.     gm_Menu.add({
  966.       menu_key2:{
  967.         text: "测试按钮2",
  968.         enable: false,
  969.         showText: (text,enable) =>  {
  970.           return "[" + (enable ? "√" : "×") + "]" + text;
  971.         },
  972.         callback: (key,status)  =>  {
  973.           console.log("点击菜单，值修改为",status);
  974.         }
  975.       }
  976.     });
  977.  
  978.     // 更新键为menu_key的显示文字和点击回调
  979.     gm_Menu.update({
  980.       menu_key:{
  981.         text: "更新后的测试按钮",
  982.         enable: true,
  983.         showText: (text,enable) =>  {
  984.           return "[" + (enable ? "√" : "×") + "]" + text;
  985.         },
  986.         callback: (key,status)  =>  {
  987.           console.log("点击菜单更新后的测试按钮，新值修改为",status);
  988.         }
  989.       }
  990.     });
  991.  
  992.     // 删除键为menu_key的菜单
  993.     gm_Menu.delete("menu_key");
  994.  
  995.     // 删除键为menu_key的菜单
  996.     gm_Menu.delete("menu_key");
  997.    **/
  998.   Utils.GM_Menu = function (
  999.     data = {},
  1000.     autoReload = false,
  1001.     _GM_getValue_,
  1002.     _GM_setValue_,
  1003.     _GM_registerMenuCommand_,
  1004.     _GM_unregisterMenuCommand_
  1005.   ) {
  1006.     if (typeof _GM_getValue_ !== "function") {
  1007.       throw new Error(
  1008.         "Utils.GM_Menu 请在脚本开头加上 @grant  GM_getValue，且传入该参数"
  1009.       );
  1010.     }
  1011.     if (typeof _GM_setValue_ !== "function") {
  1012.       throw new Error(
  1013.         "Utils.GM_Menu 请在脚本开头加上 @grant  GM_setValue，且传入该参数"
  1014.       );
  1015.     }
  1016.     if (typeof _GM_registerMenuCommand_ !== "function") {
  1017.       throw new Error(
  1018.         "Utils.GM_Menu 请在脚本开头加上 @grant  GM_registerMenuCommand，且传入该参数"
  1019.       );
  1020.     }
  1021.     if (typeof _GM_unregisterMenuCommand_ !== "function") {
  1022.       throw new Error(
  1023.         "Utils.GM_Menu 请在脚本开头加上 @grant  GM_unregisterMenuCommand，且传入该参数"
  1024.       );
  1025.     }
  1026.     let that = this;
  1027.     /**
  1028.      * 注册(不可用)的菜单的id
  1029.      * @type {...string}
  1030.      */
  1031.     let menuIdList = [];
  1032.     /**
  1033.      * 初始化数据
  1034.      */
  1035.     let init = function () {
  1036.       menuIdList = [];
  1037.       Object.keys(data).forEach((menuId) => {
  1038.         let value = _GM_getValue_(menuId);
  1039.         if (value == null) {
  1040.           _GM_setValue_(menuId, data[menuId].enable);
  1041.           value = _GM_getValue_(menuId);
  1042.         }
  1043.         data[menuId]["enable"] = value;
  1044.       });
  1045.     };
  1046.  
  1047.     /**
  1048.      * 注册(不可用)油猴菜单
  1049.      */
  1050.     let register = function () {
  1051.       Object.keys(data).forEach((menuInfoItemKey) => {
  1052.         let item = data[menuInfoItemKey];
  1053.         let text = item["text"]; /* 文本 */
  1054.         let enable = Boolean(item["enable"]); /* 用户开启的状态 */
  1055.         let showText =
  1056.           typeof item["showText"] === "function"
  1057.             ? item["showText"](text, enable)
  1058.             : text; /* 油猴菜单上显示的文本 */
  1059.         let clickCallBack = item["callback"]; /* 用户点击后的回调 */
  1060.         let menuId = _GM_registerMenuCommand_(showText, function () {
  1061.           let menuEnable = enable ? false : true;
  1062.           _GM_setValue_(menuInfoItemKey, menuEnable);
  1063.           if (typeof clickCallBack === "function") {
  1064.             clickCallBack(menuInfoItemKey, menuEnable);
  1065.           }
  1066.           if (autoReload) {
  1067.             window.location.reload();
  1068.           } else {
  1069.             that.update();
  1070.           }
  1071.         });
  1072.         menuIdList = [...menuIdList, menuId];
  1073.       });
  1074.     };
  1075.     /**
  1076.      * 获取键值开启状态
  1077.      * @param {string} menuId
  1078.      * @returns {Boolean}
  1079.      */
  1080.     this.get = function (menuId) {
  1081.       return data[menuId]["enable"];
  1082.     };
  1083.     /**
  1084.      * 新增菜单数据
  1085.      * @param {Object} paramData
  1086.      */
  1087.     this.add = function (paramData) {
  1088.       Object.assign(data, paramData);
  1089.       init();
  1090.       register();
  1091.     };
  1092.     /**
  1093.      * 更新菜单数据
  1094.      * @param {Object} paramData
  1095.      */
  1096.     this.update = function (paramData) {
  1097.       if (paramData) {
  1098.         menuIdList = Utils.assign(menuIdList, paramData);
  1099.       }
  1100.       Object.keys(menuIdList).forEach((menuId) => {
  1101.         that.delete(menuId);
  1102.       });
  1103.       init();
  1104.       register();
  1105.     };
  1106.     /**
  1107.      * 卸载菜单
  1108.      * @param {string} menuId 已注册(不可用)的菜单id
  1109.      */
  1110.     this.delete = function (menuId) {
  1111.       _GM_unregisterMenuCommand_(menuId);
  1112.     };
  1113.     init(); /* 初始化数据 */
  1114.     register(); /* 注册(不可用)到油猴菜单中 */
  1115.   };
  1116.  
  1117.   /**
  1118.    * 基于Function prototype，能够勾住和释放任何函数
  1119.    * 
  1120.    * .hook
  1121.    * + realFunc {string} 用于保存原始函数的函数名称,用于unHook
  1122.    * + hookFunc {string} 替换的hook函数
  1123.    * + context {object} 目标函数所在对象,用于hook非window对象下的函数，如String.protype.slice,carInstance1
  1124.    * + methodName {string} 匿名函数需显式传入目标函数名eg:this.Begin = function(){....};}
  1125.    * 
  1126.    * .unhook
  1127.    * + realFunc {string} 用于保存原始函数的函数名称,用于unHook
  1128.    * + funcName {string} 被Hook的函数名称
  1129.    * + context {object} 目标函数所在对象,用于hook非window对象下的函数，如String.protype.slice,carInstance1
  1130.    * @example
  1131.     let hook = new Utils.Hooks();
  1132.     hook.initEnv();
  1133.     function myFunction(){
  1134.         console.log("我自己需要执行的函数");
  1135.     }
  1136.     function testFunction(){
  1137.         console.log("正常执行的函数");
  1138.     }
  1139.     testFunction.hook(testFunction,myFunction,window);
  1140.    **/
  1141.   Utils.Hooks = function () {
  1142.     this.initEnv = function () {
  1143.       Function.prototype.hook = function (realFunc, hookFunc, context) {
  1144.         let _context = null; //函数上下文
  1145.         let _funcName = null; //函数名
  1146.  
  1147.         _context = context || window;
  1148.         _funcName = getFuncName(this);
  1149.         _context["realFunc_" + _funcName] = this;
  1150.  
  1151.         if (
  1152.           _context[_funcName].prototype &&
  1153.           _context[_funcName].prototype.isHooked
  1154.         ) {
  1155.           console.log("Already has been hooked,unhook first");
  1156.           return false;
  1157.         }
  1158.         function getFuncName(fn) {
  1159.           // 获取函数名
  1160.           let strFunc = fn.toString();
  1161.           let _regex = /function\s+(\w+)\s*\(/;
  1162.           let patten = strFunc.match(_regex);
  1163.           if (patten) {
  1164.             return patten[1];
  1165.           }
  1166.           return "";
  1167.         }
  1168.         try {
  1169.           eval(
  1170.             "_context[_funcName] = function " +
  1171.               _funcName +
  1172.               "(){\n" +
  1173.               "let args = Array.prototype.slice.call(arguments,0);\n" +
  1174.               "let obj = this;\n" +
  1175.               "hookFunc.apply(obj,args);\n" +
  1176.               "return _context['realFunc_" +
  1177.               _funcName +
  1178.               "'].apply(obj,args);\n" +
  1179.               "};"
  1180.           );
  1181.           _context[_funcName].prototype.isHooked = true;
  1182.           return true;
  1183.         } catch (e) {
  1184.           console.log("Hook failed,check the params.");
  1185.           return false;
  1186.         }
  1187.       };
  1188.       Function.prototype.unhook = function (realFunc, funcName, context) {
  1189.         let _context = null;
  1190.         let _funcName = null;
  1191.         _context = context || window;
  1192.         _funcName = funcName;
  1193.         if (!_context[_funcName].prototype.isHooked) {
  1194.           console.log("No function is hooked on");
  1195.           return false;
  1196.         }
  1197.         _context[_funcName] = _context["realFunc" + _funcName];
  1198.         delete _context["realFunc_" + _funcName];
  1199.         return true;
  1200.       };
  1201.     };
  1202.     this.cleanEnv = function () {
  1203.       if (Function.prototype.hasOwnProperty("hook")) {
  1204.         delete Function.prototype.hook;
  1205.       }
  1206.       if (Function.prototype.hasOwnProperty("unhook")) {
  1207.         delete Function.prototype.unhook;
  1208.       }
  1209.       return true;
  1210.     };
  1211.   };
  1212.  
  1213.   /**
  1214.    * 为减少代码量和回调，把GM_xmlhttpRequest封装
  1215.    * 文档地址: https://www.tampermonkey.net/documentation.php?ext=iikm
  1216.    * 其中onloadstart、onprogress、onreadystatechange是回调形式，onabort、ontimeout、onerror可以设置全局回调函数
  1217.    * @example
  1218.     let httpx = new Utils.Httpx(GM_xmlhttpRequest);
  1219.     let postResp = await httpx.post({
  1220.       url:url,
  1221.       data:JSON.stringify({
  1222.         test:1
  1223.       }),
  1224.       timeout: 5000
  1225.     });
  1226.     console.log(postResp);
  1227.     > {
  1228.       status: true,
  1229.       data: {responseText: "...", response: xxx,...},
  1230.       msg: "请求完毕",
  1231.       type: "onload",
  1232.     }
  1233.  
  1234.     if(postResp === "onload" && postResp.status){
  1235.     // onload
  1236.     }else if(postResp === "ontimeout"){
  1237.     // ontimeout
  1238.     }
  1239.    * @example
  1240.     // 也可以先配置全局参数
  1241.     let httpx = new Utils.Httpx(GM_xmlhttpRequest);
  1242.     httpx.config({
  1243.       timeout: 5000,
  1244.       async: false,
  1245.       responseType: "html",
  1246.       redirect: "follow",
  1247.     })
  1248.     // 优先级为 默认details < 全局details < 单独的details
  1249.    */
  1250.   Utils.Httpx = function (_GM_xmlHttpRequest_) {
  1251.     if (typeof _GM_xmlHttpRequest_ !== "function") {
  1252.       throw new Error(
  1253.         "Utils.Httpx 请先加入@grant GM_xmlhttpRequest在开头且传入该参数"
  1254.       );
  1255.     }
  1256.     let defaultDetails = {
  1257.       url: undefined,
  1258.       timeout: 5000,
  1259.       async: false,
  1260.       responseType: undefined,
  1261.       headers: undefined,
  1262.       data: undefined,
  1263.       redirect: undefined,
  1264.       cookie: undefined,
  1265.       binary: undefined,
  1266.       nocache: undefined,
  1267.       revalidate: undefined,
  1268.       context: undefined,
  1269.       overrideMimeType: undefined,
  1270.       anonymous: undefined,
  1271.       fetch: undefined,
  1272.       user: undefined,
  1273.       password: undefined,
  1274.       onabort: function () {},
  1275.       onerror: function () {},
  1276.       ontimeout: function () {},
  1277.       onloadstart: function () {},
  1278.       onreadystatechange: function () {},
  1279.       onprogress: function () {},
  1280.     };
  1281.  
  1282.     /**
  1283.      * 发送请求
  1284.      * @param {Object} details
  1285.      */
  1286.     function request(details) {
  1287.       _GM_xmlHttpRequest_(details);
  1288.     }
  1289.  
  1290.     /**
  1291.      * 获取请求配置
  1292.      * @param {object} method 当前请求方法，默认get
  1293.      * @param {object} resolve promise回调
  1294.      * @param {object} details 请求配置
  1295.      * @returns {object}
  1296.      */
  1297.     function getRequestDefails(method, resolve, details) {
  1298.       return {
  1299.         url: details.url || defaultDetails.url,
  1300.         method: method || "get",
  1301.         timeout: details.timeout || defaultDetails.timeout,
  1302.         async: details.async || defaultDetails.async,
  1303.         responseType: details.responseType || defaultDetails.responseType,
  1304.         headers: details.headers || defaultDetails.headers,
  1305.         data: details.data || defaultDetails.data,
  1306.         redirect: details.redirect || defaultDetails.redirect,
  1307.         cookie: details.cookie || defaultDetails.cookie,
  1308.         binary: details.binary || defaultDetails.binary,
  1309.         nocache: details.nocache || defaultDetails.nocache,
  1310.         revalidate: details.revalidate || defaultDetails.revalidate,
  1311.         context: details.context || defaultDetails.context,
  1312.         overrideMimeType:
  1313.           details.overrideMimeType || defaultDetails.overrideMimeType,
  1314.         anonymous: details.anonymous || defaultDetails.anonymous,
  1315.         fetch: details.fetch || defaultDetails.fetch,
  1316.         user: details.user || defaultDetails.user,
  1317.         password: details.password || defaultDetails.password,
  1318.         onabort: function () {
  1319.           onAbortCallBack(details, resolve, arguments);
  1320.         },
  1321.         onerror: function (response) {
  1322.           onErrorCallBack(details, resolve, response, arguments);
  1323.         },
  1324.         onloadstart: function () {
  1325.           onLoadStartCallBack(details, arguments);
  1326.         },
  1327.         onprogress: function () {
  1328.           onProgressCallBack(details, arguments);
  1329.         },
  1330.         onreadystatechange: function () {
  1331.           onReadyStateChangeCallBack(details, arguments);
  1332.         },
  1333.         ontimeout: function () {
  1334.           onTimeoutCallBack(details, resolve, arguments);
  1335.         },
  1336.         onload: function (response) {
  1337.           onLoadCallBack(details, resolve, response);
  1338.         },
  1339.       };
  1340.     }
  1341.     /**
  1342.      * 处理发送请求的details，去除值为undefined、空function的值
  1343.      * @param {object} details
  1344.      * @returns {object}
  1345.      */
  1346.     function handleRequestDetails(details) {
  1347.       Object.keys(details).forEach((keyName) => {
  1348.         if (
  1349.           details[keyName] == null ||
  1350.           (details[keyName] instanceof Function &&
  1351.             Utils.isNull(details[keyName]))
  1352.         ) {
  1353.           delete details[keyName];
  1354.           return;
  1355.         }
  1356.       });
  1357.       if (Utils.isNull(details.url)) {
  1358.         throw Error(`Utils.Httpx 参数 url不符合要求: ${details.url}`);
  1359.       }
  1360.       /* method值统一大写，兼容Via */
  1361.       details.method = details.method.toUpperCase();
  1362.       return details;
  1363.     }
  1364.  
  1365.     /**
  1366.      * onabort请求被取消-触发
  1367.      * @param {object} details 配置
  1368.      * @param {object} resolve 回调
  1369.      * @param {object} argumentsList 参数列表
  1370.      */
  1371.     function onAbortCallBack(details, resolve, argumentsList) {
  1372.       if ("onabort" in details) {
  1373.         details.onabort(...argumentsList);
  1374.       } else {
  1375.         defaultDetails?.onabort(...argumentsList);
  1376.       }
  1377.       resolve({
  1378.         status: false,
  1379.         data: argumentsList,
  1380.         msg: "请求被取消",
  1381.         type: "onabort",
  1382.       });
  1383.     }
  1384.  
  1385.     /**
  1386.      * onerror请求异常-触发
  1387.      * @param {object} details 配置
  1388.      * @param {object} resolve 回调
  1389.      * @param {object} response 响应
  1390.      * @param {object} argumentsList 参数列表
  1391.      */
  1392.     function onErrorCallBack(details, resolve, response, argumentsList) {
  1393.       if ("onerror" in details) {
  1394.         details.onerror(...argumentsList);
  1395.       } else {
  1396.         defaultDetails?.onerror(...argumentsList);
  1397.       }
  1398.       resolve({
  1399.         status: false,
  1400.         data: response,
  1401.         msg: "请求异常",
  1402.         type: "onerror",
  1403.       });
  1404.     }
  1405.     /**
  1406.      * ontimeout请求超时-触发
  1407.      * @param {object} details 配置
  1408.      * @param {object} resolve 回调
  1409.      * @param {object} argumentsList 参数列表
  1410.      */
  1411.     function onTimeoutCallBack(details, resolve, argumentsList) {
  1412.       if ("ontimeout" in details) {
  1413.         details.ontimeout(...argumentsList);
  1414.       } else {
  1415.         defaultDetails?.ontimeout(...argumentsList);
  1416.       }
  1417.       resolve({
  1418.         status: false,
  1419.         data: argumentsList,
  1420.         msg: "请求超时",
  1421.         type: "ontimeout",
  1422.       });
  1423.     }
  1424.  
  1425.     /**
  1426.      * onloadstart请求开始-触发
  1427.      * @param {object} details 配置
  1428.      * @param {object} argumentsList 参数列表
  1429.      */
  1430.     function onLoadStartCallBack(details, argumentsList) {
  1431.       if ("onloadstart" in details) {
  1432.         details.onloadstart(...argumentsList);
  1433.       } else {
  1434.         defaultDetails?.onloadstart(...argumentsList);
  1435.       }
  1436.     }
  1437.  
  1438.     /**
  1439.      * onreadystatechange准备状态改变-触发
  1440.      * @param {object} details 配置
  1441.      * @param {object} argumentsList 参数列表
  1442.      */
  1443.     function onReadyStateChangeCallBack(details, argumentsList) {
  1444.       if ("onreadystatechange" in details) {
  1445.         details.onreadystatechange(...argumentsList);
  1446.       } else {
  1447.         defaultDetails?.onreadystatechange(...argumentsList);
  1448.       }
  1449.     }
  1450.  
  1451.     /**
  1452.      * onprogress上传进度-触发
  1453.      * @param {object} details 配置
  1454.      * @param {object} argumentsList 参数列表
  1455.      */
  1456.     function onProgressCallBack(details, argumentsList) {
  1457.       if ("onprogress" in details) {
  1458.         details.onprogress(...argumentsList);
  1459.       } else {
  1460.         defaultDetails?.onprogress(...argumentsList);
  1461.       }
  1462.     }
  1463.  
  1464.     /**
  1465.      * onload加载完毕-触发
  1466.      * @param {object} details 配置
  1467.      * @param {object} resolve 回调
  1468.      * @param {object} response 响应
  1469.      */
  1470.     function onLoadCallBack(details, resolve, response) {
  1471.       /* X浏览器会因为设置了responseType导致不返回responseText */
  1472.       if (
  1473.         details.responseType === "json" &&
  1474.         Utils.isNull(response.responseText) &&
  1475.         typeof response.response === "object"
  1476.       ) {
  1477.         Utils.tryCatch().run(() => {
  1478.           response.responseText = JSON.stringify(response.response);
  1479.         });
  1480.       }
  1481.       resolve({
  1482.         status: true,
  1483.         data: response,
  1484.         msg: "请求完毕",
  1485.         type: "onload",
  1486.       });
  1487.     }
  1488.  
  1489.     /**
  1490.      * GET 请求
  1491.      * @param {object} details
  1492.      * @returns {Promise}
  1493.      */
  1494.     this.get = function (details) {
  1495.       return new Promise((resolve) => {
  1496.         let requestDetails = getRequestDefails("get", resolve, details);
  1497.         delete requestDetails.onprogress;
  1498.         requestDetails = handleRequestDetails(requestDetails);
  1499.         request(requestDetails);
  1500.       });
  1501.     };
  1502.     /**
  1503.      * POST 请求
  1504.      * @param {object} details
  1505.      * @returns {Promise}
  1506.      */
  1507.     this.post = function (details) {
  1508.       return new Promise((resolve) => {
  1509.         let requestDetails = getRequestDefails("post", resolve, details);
  1510.         requestDetails = handleRequestDetails(requestDetails);
  1511.         request(requestDetails);
  1512.       });
  1513.     };
  1514.     /**
  1515.      * HEAD 请求
  1516.      * @param {object} details
  1517.      * @returns {Promise}
  1518.      */
  1519.     this.head = function (details) {
  1520.       return new Promise((resolve) => {
  1521.         let requestDetails = getRequestDefails("head", resolve, details);
  1522.         delete requestDetails.onprogress;
  1523.         requestDetails = handleRequestDetails(requestDetails);
  1524.         request(requestDetails);
  1525.       });
  1526.     };
  1527.  
  1528.     /**
  1529.      * OPTIONS请求
  1530.      * @param {object} details
  1531.      * @returns {Promise}
  1532.      */
  1533.     this.options = function (details) {
  1534.       return new Promise((resolve) => {
  1535.         let requestDetails = getRequestDefails("options", resolve, details);
  1536.         delete requestDetails.onprogress;
  1537.         requestDetails = handleRequestDetails(requestDetails);
  1538.         request(requestDetails);
  1539.       });
  1540.     };
  1541.  
  1542.     /**
  1543.      * DELETE请求
  1544.      * @param {object} details
  1545.      */
  1546.     this.delete = function (details) {
  1547.       return new Promise((resolve) => {
  1548.         let requestDetails = getRequestDefails("delete", resolve, details);
  1549.         delete requestDetails.onprogress;
  1550.         requestDetails = handleRequestDetails(requestDetails);
  1551.         request(requestDetails);
  1552.       });
  1553.     };
  1554.  
  1555.     /**
  1556.      * PUT请求
  1557.      * @param {object} details
  1558.      * @returns {Promise}
  1559.      */
  1560.     this.put = function (details) {
  1561.       return new Promise((resolve) => {
  1562.         let requestDetails = getRequestDefails("put", resolve, details);
  1563.         requestDetails = handleRequestDetails(requestDetails);
  1564.         request(requestDetails);
  1565.       });
  1566.     };
  1567.  
  1568.     /**
  1569.      * 修改默认配置
  1570.      * @param {Object} details
  1571.      */
  1572.     this.config = function (details) {
  1573.       defaultDetails = Utils.assign(defaultDetails, details);
  1574.     };
  1575.   };
  1576.  
  1577.   /**
  1578.    * 浏览器端的indexedDB操作封装
  1579.    * @example
  1580.     let db = new Utils.indexedDB('web_DB', 'nav_text')
  1581.     let data = {name:'管理员', roleId: 1, type: 1};
  1582.     db.save('list',data).then((resolve)=>{
  1583.         console.log(resolve,'存储成功')
  1584.     })
  1585.  
  1586.     db.get('list').then((resolve)=>{
  1587.         console.log(resolve,'查询成功')
  1588.     })
  1589.  
  1590.     db.getPaging('list',20,10).then((resolve)=>{
  1591.         console.log(resolve,'查询分页偏移第20，一共10行成功');
  1592.     })
  1593.  
  1594.     db.delete('list').then(resolve=>{
  1595.         console.log(resolve,'删除成功---->>>>>>name')
  1596.     })
  1597.  
  1598.     db.deleteAll().then(resolve=>{
  1599.         console.log(resolve,'清除数据库---->>>>>>name')
  1600.     })
  1601.    * @param {string} dbName 数据存储名
  1602.    * @param {string} storeName 表名
  1603.    * @param {number} dbVersion indexDB的版本号
  1604.    **/
  1605.   Utils.indexedDB = function (
  1606.     dbName = "default_db",
  1607.     storeName = "default_form",
  1608.     dbVersion = 1
  1609.   ) {
  1610.     this.dbName = dbName;
  1611.     this.slqVersion =
  1612.       "1"; /* websql的版本号，由于ios的问题，版本号的写法不一样 */
  1613.     this.dbVersion = dbVersion;
  1614.     this.storeName = storeName;
  1615.     this.indexedDB =
  1616.       window.indexedDB ||
  1617.       window.mozIndexedDB ||
  1618.       window.webkitIndexedDB ||
  1619.       window.msIndexedDB; /* 监听IndexDB */
  1620.     if (!this.indexedDB) {
  1621.       alert("很抱歉，您的浏览器不支持indexedDB");
  1622.     }
  1623.     this.db = {}; /* 缓存数据库，避免同一个页面重复创建和销毁 */
  1624.     this.store = null;
  1625.     this.errorCode = {
  1626.       /* 错误码 */
  1627.       success: {
  1628.         code: 200,
  1629.         msg: "操作成功",
  1630.       },
  1631.       error: {
  1632.         code: 401,
  1633.         msg: "操作失败",
  1634.       },
  1635.       open: { code: 91001, msg: "打开数据库失败" },
  1636.       save: { code: 91002, msg: "保存数据失败" },
  1637.       get: { code: 91003, msg: "获取数据失败" },
  1638.       delete: { code: 91004, msg: "删除数据失败" },
  1639.       deleteAll: { code: 91005, msg: "清空数据库失败" },
  1640.     };
  1641.     let that = this;
  1642.     /**
  1643.      * 创建 “表”
  1644.      * @param {String} dbName 表名
  1645.      * @returns
  1646.      */
  1647.     this.createStore = function (dbName) {
  1648.       let txn, store;
  1649.       if (that.indexedDB) {
  1650.         /* 如果是支持IndexDB的 */
  1651.         txn = that.db[dbName].transaction(
  1652.           that.storeName,
  1653.           "readwrite"
  1654.         ); /* IndexDB的读写权限 */
  1655.         store = txn.objectStore(that.storeName);
  1656.       }
  1657.       return store;
  1658.     };
  1659.     /**
  1660.      * 打开数据库
  1661.      * @param {Function} callback  回调
  1662.      * @param {String} dbName 数据库名
  1663.      */
  1664.     this.open = function (callback, dbName) {
  1665.       /* 打开数据库 */
  1666.       if (that.indexedDB) {
  1667.         /* 如果支持IndexDB */
  1668.         if (!that.db[dbName]) {
  1669.           /* 如果缓存中没有，则进行数据库的创建或打开，提高效率 */
  1670.           let request = that.indexedDB.open(dbName, that.dbVersion);
  1671.           request.onerror = function (e) {
  1672.             callback({
  1673.               code: that.errorCode.open.code,
  1674.               msg: that.errorCode.open.msg,
  1675.               error: e,
  1676.             });
  1677.           };
  1678.           request.onsuccess = function (e) {
  1679.             if (!that.db[dbName]) {
  1680.               that.db[dbName] = e.target.result;
  1681.             }
  1682.             let store = that.createStore(dbName);
  1683.             callback(store);
  1684.           };
  1685.           request.onupgradeneeded = function (e) {
  1686.             that.db[dbName] = e.target.result;
  1687.             let store = that.db[dbName].createObjectStore(that.storeName, {
  1688.               keyPath: "key",
  1689.             });
  1690.             store.transaction.oncomplete = function (event) {
  1691.               callback(store);
  1692.             };
  1693.           };
  1694.         } else {
  1695.           /* 如果缓存中已经打开了数据库，就直接使用 */
  1696.           let store = that.createStore(dbName);
  1697.           callback(store);
  1698.         }
  1699.       }
  1700.     };
  1701.     /**
  1702.      * 保存数据到数据库
  1703.      * @param {any} key 数据key
  1704.      * @param {any} value 数据值
  1705.      * @returns
  1706.      */
  1707.     this.save = function (key, value) {
  1708.       if (that.indexedDB) {
  1709.         return new Promise((resolve, reject) => {
  1710.           let dbName = that.dbName;
  1711.           let inData = {
  1712.             key: key,
  1713.             value: value,
  1714.           };
  1715.           that.open(function (result) {
  1716.             let error = result.hasOwnProperty("error");
  1717.             if (error) {
  1718.               resolve(result);
  1719.             } else {
  1720.               let request = result.put(inData);
  1721.               request.onsuccess = function (e) {
  1722.                 resolve({
  1723.                   code: that.errorCode.success.code,
  1724.                   msg: that.errorCode.success.msg,
  1725.                   success: true,
  1726.                 }); /* 保存成功有success 字段 */
  1727.               };
  1728.               request.onerror = function (e) {
  1729.                 resolve({
  1730.                   code: that.errorCode.save.code,
  1731.                   msg: that.errorCode.save.msg,
  1732.                   error: e,
  1733.                 });
  1734.               };
  1735.             }
  1736.           }, dbName);
  1737.         });
  1738.       }
  1739.     };
  1740.     /**
  1741.      * 根据key获取值
  1742.      * @param {string} key 数据key
  1743.      * @returns {Promise}
  1744.      */
  1745.     this.get = function (key) {
  1746.       return new Promise((resolve, reject) => {
  1747.         let dbName = that.dbName;
  1748.         if (that.indexedDB) {
  1749.           that.open(function (result) {
  1750.             let error =
  1751.               result.hasOwnProperty(
  1752.                 "error"
  1753.               ); /* 判断返回的数据中是否有error字段 */
  1754.             if (error) {
  1755.               reject({
  1756.                 code: that.errorCode.open.get,
  1757.                 msg: that.errorCode.get.msg,
  1758.                 error: error,
  1759.                 result: result,
  1760.               });
  1761.             } else {
  1762.               let request = result.get(key);
  1763.               request.onsuccess = function (e) {
  1764.                 let result = e.target.result;
  1765.                 let data = result ? result.value : undefined;
  1766.                 resolve({
  1767.                   code: data
  1768.                     ? that.errorCode.success.code
  1769.                     : that.errorCode.error.code,
  1770.                   msg: data
  1771.                     ? that.errorCode.success.msg
  1772.                     : that.errorCode.error.msg,
  1773.                   data: data || [],
  1774.                   success: true,
  1775.                 });
  1776.               };
  1777.               request.onerror = function (e) {
  1778.                 reject({
  1779.                   code: that.errorCode.get.code,
  1780.                   msg: that.errorCode.get.msg,
  1781.                   result: result,
  1782.                   error: e,
  1783.                 });
  1784.               };
  1785.             }
  1786.           }, dbName);
  1787.         }
  1788.       });
  1789.     };
  1790.     /**
  1791.      * 正则获取数据
  1792.      * @param {string} key 数据键
  1793.      * @returns
  1794.      */
  1795.     this.regexpGet = function (key) {
  1796.       let list = [];
  1797.       return new Promise((resolve, reject) => {
  1798.         /* 正则查询 */
  1799.         let dbName = that.dbName;
  1800.         if (that.indexedDB) {
  1801.           that.open(function (result) {
  1802.             let error =
  1803.               result.hasOwnProperty(
  1804.                 "error"
  1805.               ); /* 判断返回的数据中是否有error字段 */
  1806.             if (error) {
  1807.               reject({
  1808.                 code: that.errorCode.open.get,
  1809.                 msg: that.errorCode.get.msg,
  1810.                 error: error,
  1811.                 result: result,
  1812.               });
  1813.             } else {
  1814.               let request = result.getAll();
  1815.               request.onsuccess = function (e) {
  1816.                 let result = e.target.result;
  1817.                 if (result.length !== 0) {
  1818.                   result.forEach((item, index) => {
  1819.                     if (item["key"].match(key)) {
  1820.                       let concatList = item["value"];
  1821.                       concatList["key"] = item["key"];
  1822.                       list = [...list, concatList];
  1823.                     }
  1824.                   });
  1825.                 }
  1826.                 resolve({
  1827.                   code: that.errorCode.success.code,
  1828.                   msg: that.errorCode.success.msg,
  1829.                   data: list,
  1830.                   success: true,
  1831.                 });
  1832.               };
  1833.               request.onerror = function (e) {
  1834.                 reject({
  1835.                   code: that.errorCode.get.code,
  1836.                   msg: that.errorCode.get.msg,
  1837.                   result: result,
  1838.                   error: e,
  1839.                 });
  1840.               };
  1841.             }
  1842.           }, dbName);
  1843.         }
  1844.       });
  1845.     };
  1846.     /**
  1847.      * 删除数据
  1848.      * @param {string} key 数据键
  1849.      * @returns
  1850.      */
  1851.     this.delete = function (key) {
  1852.       return new Promise((resolve, reject) => {
  1853.         /* 根据key删除某条数据 */
  1854.         let dbName = that.dbName;
  1855.         if (that.indexedDB) {
  1856.           that.open(function (result) {
  1857.             let error = result.hasOwnProperty("error");
  1858.             if (error) {
  1859.               resolve(result);
  1860.             } else {
  1861.               let request = result.get(key);
  1862.               request.onsuccess = function (e) {
  1863.                 let recode = e.target.result;
  1864.                 if (recode) {
  1865.                   request = result.delete(key);
  1866.                 }
  1867.                 resolve({
  1868.                   code: recode
  1869.                     ? that.errorCode.success.code
  1870.                     : that.errorCode.error.code,
  1871.                   msg: recode
  1872.                     ? that.errorCode.success.msg
  1873.                     : that.errorCode.error.msg,
  1874.                   success: true,
  1875.                 });
  1876.               };
  1877.               request.onerror = function (e) {
  1878.                 resolve({
  1879.                   code: that.errorCode.delete.code,
  1880.                   msg: that.errorCode.delete.msg,
  1881.                   error: e,
  1882.                 });
  1883.               };
  1884.             }
  1885.           }, dbName);
  1886.         }
  1887.       });
  1888.     };
  1889.     /**
  1890.      * 删除所有数据
  1891.      * @returns
  1892.      */
  1893.     this.deleteAll = function () {
  1894.       return new Promise((resolve, reject) => {
  1895.         /* 清空数据库 */
  1896.         let dbName = that.dbName;
  1897.         if (that.indexedDB) {
  1898.           that.open(function (result) {
  1899.             let error = result.hasOwnProperty("error");
  1900.             if (error) {
  1901.               resolve({
  1902.                 code: that.errorCode.deleteAll.code,
  1903.                 msg: that.errorCode.deleteAll.msg,
  1904.                 error: error,
  1905.                 result: result,
  1906.               });
  1907.             } else {
  1908.               result.clear();
  1909.               resolve({
  1910.                 code: that.errorCode.success.code,
  1911.                 msg: that.errorCode.success.msg,
  1912.                 success: true,
  1913.               });
  1914.             }
  1915.           }, dbName);
  1916.         }
  1917.       });
  1918.     };
  1919.   };
  1920.  
  1921.   /**
  1922.    * 判断函数是否是Native
  1923.    * @param {function} func
  1924.    * @returns {boolean}
  1925.    * + true 是Native
  1926.    * + false 不是Native
  1927.    * @example
  1928.    * Utils.isNativeFunc(window.location.assign)
  1929.    * > true
  1930.    */
  1931.   Utils.isNativeFunc = function (func) {
  1932.     return Boolean(
  1933.       func.toString().match(/^function .*\(\) { \[native code\] }$/)
  1934.     );
  1935.   };
  1936.  
  1937.   /**
  1938.    * 判断当前的位置是否位于页面底部附近
  1939.    * @param {number} nearValue 判断在页面底部的误差值，默认:50
  1940.    * @returns {boolean}
  1941.    * + true 在底部附近
  1942.    * + false 不在底部附近
  1943.    */
  1944.   Utils.isNearBottom = function (nearValue = 50) {
  1945.     var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
  1946.     var windowHeight =
  1947.       window.innerHeight || document.documentElement.clientHeight;
  1948.     var documentHeight = document.documentElement.scrollHeight;
  1949.     return scrollTop + windowHeight >= documentHeight - nearValue;
  1950.   };
  1951.  
  1952.   /**
  1953.    * 判断对象是否是元素
  1954.    * @param {any} obj
  1955.    * @returns {boolean}
  1956.    * + true 是元素
  1957.    * + false 不是元素
  1958.    * @example
  1959.    * Utils.isDOM(document.querySelector("a"))
  1960.    * > true
  1961.    */
  1962.   Utils.isDOM = function (obj) {
  1963.     return obj instanceof HTMLElement || obj instanceof Node;
  1964.   };
  1965.  
  1966.   /**
  1967.    * 判断对象是否是jQuery对象
  1968.    * @param {any} obj
  1969.    * @returns {boolean}
  1970.    * + true 是jQuery对象
  1971.    * + false 不是jQuery对象
  1972.    * @example
  1973.    * Utils.isJQuery($("a"))
  1974.    * > true
  1975.    */
  1976.   Utils.isJQuery = function (obj) {
  1977.     let result = false;
  1978.     if (typeof jQuery === "object" && obj instanceof jQuery) {
  1979.       result = true;
  1980.     }
  1981.     if (typeof obj === "object") {
  1982.       /* 也有种可能，这个jQuery对象是1.8.3版本的，页面中的jQuery是3.4.1版本的 */
  1983.       let jQueryProps = [
  1984.         "add",
  1985.         "addBack",
  1986.         "addClass",
  1987.         "after",
  1988.         "ajaxComplete",
  1989.         "ajaxError",
  1990.         "ajaxSend",
  1991.         "ajaxStart",
  1992.         "ajaxStop",
  1993.         "ajaxSuccess",
  1994.         "animate",
  1995.         "append",
  1996.         "appendTo",
  1997.         "attr",
  1998.         "before",
  1999.         "bind",
  2000.         "blur",
  2001.         "change",
  2002.         "children",
  2003.         "clearQueue",
  2004.         "click",
  2005.         "clone",
  2006.         "closest",
  2007.         "constructor",
  2008.         "contents",
  2009.         "contextmenu",
  2010.         "css",
  2011.         "data",
  2012.         "dblclick",
  2013.         "delay",
  2014.         "delegate",
  2015.         "dequeue",
  2016.         "each",
  2017.         "empty",
  2018.         "end",
  2019.         "eq",
  2020.         "extend",
  2021.         "fadeIn",
  2022.         "fadeOut",
  2023.         "fadeTo",
  2024.         "fadeToggle",
  2025.         "filter",
  2026.         "find",
  2027.         "first",
  2028.         "focus",
  2029.         "focusin",
  2030.         "focusout",
  2031.         "get",
  2032.         "has",
  2033.         "hasClass",
  2034.         "height",
  2035.         "hide",
  2036.         "hover",
  2037.         "html",
  2038.         "index",
  2039.         "init",
  2040.         "innerHeight",
  2041.         "innerWidth",
  2042.         "insertAfter",
  2043.         "insertBefore",
  2044.         "is",
  2045.         "jquery",
  2046.         "keydown",
  2047.         "keypress",
  2048.         "keyup",
  2049.         "last",
  2050.         "load",
  2051.         "map",
  2052.         "mousedown",
  2053.         "mouseenter",
  2054.         "mouseleave",
  2055.         "mousemove",
  2056.         "mouseout",
  2057.         "mouseover",
  2058.         "mouseup",
  2059.         "next",
  2060.         "nextAll",
  2061.         "not",
  2062.         "off",
  2063.         "offset",
  2064.         "offsetParent",
  2065.         "on",
  2066.         "one",
  2067.         "outerHeight",
  2068.         "outerWidth",
  2069.         "parent",
  2070.         "parents",
  2071.         "position",
  2072.         "prepend",
  2073.         "prependTo",
  2074.         "prev",
  2075.         "prevAll",
  2076.         "prevUntil",
  2077.         "promise",
  2078.         "prop",
  2079.         "pushStack",
  2080.         "queue",
  2081.         "ready",
  2082.         "remove",
  2083.         "removeAttr",
  2084.         "removeClass",
  2085.         "removeData",
  2086.         "removeProp",
  2087.         "replaceAll",
  2088.         "replaceWith",
  2089.         "resize",
  2090.         "scroll",
  2091.         "scrollLeft",
  2092.         "scrollTop",
  2093.         "select",
  2094.         "show",
  2095.         "siblings",
  2096.         "slice",
  2097.         "slideDown",
  2098.         "slideToggle",
  2099.         "slideUp",
  2100.         "sort",
  2101.         "splice",
  2102.         "text",
  2103.         "toArray",
  2104.         "toggle",
  2105.         "toggleClass",
  2106.         "trigger",
  2107.         "triggerHandler",
  2108.         "unbind",
  2109.         "width",
  2110.         "wrap",
  2111.       ];
  2112.       for (const jQueryPropsName of jQueryProps) {
  2113.         if (!(jQueryPropsName in obj)) {
  2114.           result = false;
  2115.           /* console.log(jQueryPropsName); */
  2116.           break;
  2117.         } else {
  2118.           result = true;
  2119.         }
  2120.       }
  2121.     }
  2122.     return result;
  2123.   };
  2124.  
  2125.   /**
  2126.    * 判断当前设备是否是移动端
  2127.    * @return {boolean}
  2128.    * + true 是移动端
  2129.    * + false 不是移动端
  2130.    * @example
  2131.    * Utils.isPhone();
  2132.    * > true
  2133.    **/
  2134.   Utils.isPhone = function () {
  2135.     return Boolean(/(iPhone|iPad|iPod|iOS|Android)/i.test(navigator.userAgent));
  2136.   };
  2137.  
  2138.   /**
  2139.    * 判断对象是否不为空
  2140.    * @param {any} obj
  2141.    * @returns {boolean}
  2142.    * + true 不为空
  2143.    * + false 为空
  2144.    * @example
  2145.    * Utils.isNotNull("123");
  2146.    * > true
  2147.    */
  2148.   Utils.isNotNull = function () {
  2149.     return !Utils.isNull(arguments);
  2150.   };
  2151.  
  2152.   /**
  2153.    * 判断对象或数据是否为空
  2154.    * String类型，如 ""、"null"、"undefined"、"   "
  2155.    * Number类型，如 0
  2156.    * Object类型，如 {}
  2157.    * @param {arguments} obj 需要判断的变量
  2158.    * @returns {boolean}
  2159.    * + true 为空
  2160.    * + false 不为空
  2161.    * @example
  2162.     Utils.isNull({});
  2163.     > true
  2164.    * @example
  2165.     Utils.isNull([]);
  2166.     > true
  2167.    * @example
  2168.     Utils.isNull(" ");
  2169.     > true
  2170.    * @example
  2171.     Utils.isNull(function(){});
  2172.     > true
  2173.    * @example
  2174.     Utils.isNull(()=>{}));
  2175.     > true
  2176.    * @example
  2177.     Utils.isNull("undefined");
  2178.     > true
  2179.    * @example
  2180.     Utils.isNull("null");
  2181.     > true
  2182.    * @example
  2183.     Utils.isNull(" ", false);
  2184.     > true
  2185.    * @example
  2186.     Utils.isNull([1],[]);
  2187.     > false
  2188.    * @example
  2189.     Utils.isNull([],[1]);
  2190.     > false
  2191.    * @example
  2192.     Utils.isNull(false,[123]);
  2193.     > false
  2194.    **/
  2195.   Utils.isNull = function () {
  2196.     let result = true;
  2197.     let checkList = [...arguments];
  2198.     for (const objItem of checkList) {
  2199.       let itemResult = false;
  2200.       switch (typeof objItem) {
  2201.         case "undefined":
  2202.         case "null":
  2203.           itemResult = true;
  2204.           break;
  2205.         case "object":
  2206.           /* object类型的也可能是null */
  2207.           if (objItem == null) {
  2208.             itemResult = true;
  2209.           } else if (
  2210.             Array.isArray(objItem) ||
  2211.             objItem instanceof NodeList ||
  2212.             objItem instanceof FileList
  2213.           ) {
  2214.             itemResult = objItem.length === 0;
  2215.           } else if (objItem instanceof Map || objItem instanceof Set) {
  2216.             itemResult = objItem.size === 0;
  2217.           } else {
  2218.             itemResult = Object.keys(objItem).length === 0;
  2219.           }
  2220.           break;
  2221.         case "number":
  2222.           itemResult = objItem === 0;
  2223.           break;
  2224.         case "string":
  2225.           itemResult =
  2226.             objItem.trim() === "" ||
  2227.             objItem === "null" ||
  2228.             objItem === "undefined";
  2229.           break;
  2230.         case "boolean":
  2231.           itemResult = !objItem;
  2232.           break;
  2233.         case "function":
  2234.           let funcStr = objItem.toString().replace(/\s/g, "");
  2235.           /* 排除()=>{}、(xxx="")=>{}、function(){}、function(xxx=""){}、 */
  2236.           itemResult = Boolean(
  2237.             funcStr.match(/^\(.*?\)=>\{\}$|^function.*?\(.*?\)\{\}$/)
  2238.           );
  2239.           break;
  2240.       }
  2241.       result = result && itemResult;
  2242.     }
  2243.  
  2244.     return result;
  2245.   };
  2246.  
  2247.   /**
  2248.    * 判断元素是否在页面中可见
  2249.    * @param {[...HTMLElement]|NodeList} dom 需要检查的元素，可以是普通元素|数组形式的元素|通过querySelectorAll获取的元素数组
  2250.    * @param {boolean} inView
  2251.    * + true 在窗口可视区域
  2252.    * + false 不在窗口可视区域
  2253.    * @returns {boolean}
  2254.    * + true 可见
  2255.    * + false 不可见
  2256.    * @example
  2257.    * Utils.isVisible(document.documentElement)
  2258.    * > true
  2259.    */
  2260.   Utils.isVisible = function (dom, inView = false) {
  2261.     let needCheckDomList = [];
  2262.     if (dom instanceof Array || dom instanceof NodeList) {
  2263.       needCheckDomList = [...dom];
  2264.     } else {
  2265.       needCheckDomList = [dom];
  2266.     }
  2267.     let result = true;
  2268.     for (const domItem of needCheckDomList) {
  2269.       let domDisplay = window.getComputedStyle(domItem);
  2270.       if (domDisplay.display === "none") {
  2271.         result = false;
  2272.       } else {
  2273.         let domClientRect = domItem.getBoundingClientRect();
  2274.         if (inView) {
  2275.           let viewportWidth =
  2276.             window.innerWidth || document.documentElement.clientWidth;
  2277.           let viewportHeight =
  2278.             window.innerHeight || document.documentElement.clientHeight;
  2279.           result = !(
  2280.             domClientRect.right < 0 ||
  2281.             domClientRect.left > viewportWidth ||
  2282.             domClientRect.bottom < 0 ||
  2283.             domClientRect.top > viewportHeight
  2284.           );
  2285.         } else {
  2286.           result = !(
  2287.             domClientRect.bottom === 0 &&
  2288.             domClientRect.height === 0 &&
  2289.             domClientRect.left === 0 &&
  2290.             domClientRect.right === 0 &&
  2291.             domClientRect.top === 0 &&
  2292.             domClientRect.width === 0 &&
  2293.             domClientRect.x === 0 &&
  2294.             domClientRect.y === 0
  2295.           );
  2296.         }
  2297.       }
  2298.       if (!result) {
  2299.         /* 有一个不可见就退出循环 */
  2300.         break;
  2301.       }
  2302.     }
  2303.     return result;
  2304.   };
  2305.  
  2306.   /**
  2307.    * 判断是否是Via浏览器环境
  2308.    * @returns {boolean}
  2309.    * + true 是Via
  2310.    * + false 不是Via
  2311.    * @example
  2312.    * Utils.isWebView_Via()
  2313.    * > false
  2314.    */
  2315.   Utils.isWebView_Via = function () {
  2316.     let result = true;
  2317.     if (typeof top.window.via === "object") {
  2318.       for (const key in Object.values(top.window.via)) {
  2319.         if (Object.hasOwnProperty.call(top.window.via, key)) {
  2320.           let objValueFunc = top.window.via[key];
  2321.           if (
  2322.             typeof objValueFunc === "function" &&
  2323.             Utils.isNativeFunc(objValueFunc)
  2324.           ) {
  2325.             result = true;
  2326.           } else {
  2327.             result = false;
  2328.             break;
  2329.           }
  2330.         }
  2331.       }
  2332.     } else {
  2333.       result = false;
  2334.     }
  2335.     return result;
  2336.   };
  2337.  
  2338.   /**
  2339.    * 判断是否是X浏览器环境
  2340.    * @returns {boolean}
  2341.    * + true 是X浏览器
  2342.    * + false 不是X浏览器
  2343.    * @example
  2344.    * Utils.isWebView_X()
  2345.    * > false
  2346.    */
  2347.   Utils.isWebView_X = function () {
  2348.     let result = true;
  2349.     if (typeof top.window.mbrowser === "object") {
  2350.       for (const key in Object.values(top.window.mbrowser)) {
  2351.         if (Object.hasOwnProperty.call(top.window.mbrowser, key)) {
  2352.           let objValueFunc = top.window.mbrowser[key];
  2353.           if (
  2354.             typeof objValueFunc === "function" &&
  2355.             Utils.isNativeFunc(objValueFunc)
  2356.           ) {
  2357.             result = true;
  2358.           } else {
  2359.             result = false;
  2360.             break;
  2361.           }
  2362.         }
  2363.       }
  2364.     } else {
  2365.       result = false;
  2366.     }
  2367.     return result;
  2368.   };
  2369.  
  2370.   /**
  2371.    * 把Object内的value值全部取出成Array
  2372.    * @param {Object} obj JSON数据
  2373.    * @return {Object} 返回数组
  2374.    * @example
  2375.    * Utils.parseObjectToArray({"工具类":"jsonToArray","return","Array"});
  2376.    * @return ['jsonToArray', 'Array']
  2377.    **/
  2378.   Utils.parseObjectToArray = function (obj) {
  2379.     if (typeof obj !== "object") {
  2380.       throw new Error("Utils.parseObjectToArray 参数 obj 必须为 object 类型");
  2381.     }
  2382.     let result = [];
  2383.     Object.keys(obj).forEach(function (keyName) {
  2384.       result = result.concat(obj[keyName]);
  2385.     });
  2386.     return result;
  2387.   };
  2388.  
  2389.   /**
  2390.    * 监听某个元素键盘按键事件或window全局按键事件
  2391.    * @param {Window|Node|HTMLElement} listenObj 需要监听的对象，可以是全局Window或者某个元素
  2392.    * @param {Function|undefined} callback 自己定义的回调事件，参数1为当前的key，参数2为组合按键，数组类型，包含ctrl、shift、alt和meta（win键或mac的cmd键）
  2393.    * @example 
  2394.       Utils.listenKeyPress(window,(keyName,otherKey)=>{
  2395.           if(keyName === "Enter"){
  2396.               console.log("回车按键")
  2397.           }
  2398.           if(otherKey.indexOf("ctrl") && keyName === "Enter" ){
  2399.               console.log("Ctrl和回车键");
  2400.         }
  2401.       })
  2402.    * @example
  2403.   字母和数字键的键码值(keyCode)
  2404. 	按键	键码	按键	键码	按键	键码	按键	键码
  2405. 	A	65	J	74	S	83	1	49
  2406. 	B	66	K	75	T	84	2	50
  2407. 	C	67	L	76	U	85	3	51
  2408. 	D	68	M	77	V	86	4	52
  2409. 	E	69	N	78	W	87	5	53
  2410. 	F	70	O	79	X	88	6	54
  2411. 	G	71	P	80	Y	89	7	55
  2412. 	H	72	Q	81	Z	90	8	56
  2413. 	I	73	R	82	0	48	9	57
  2414.  
  2415. 	数字键盘上的键的键码值(keyCode)	
  2416. 	功能键键码值(keyCode)
  2417. 	按键	键码	按键  	键码	按键	键码	按键	键码
  2418. 	0	96	8	104	F1	112	F7	118
  2419. 	1	97	9	105	F2	113	F8	119
  2420. 	2	98	*	106	F3	114	F9	120
  2421. 	3	99	+	107	F4	115	F10	121
  2422. 	4	100	Enter	108	F5	116	F11	122
  2423. 	5	101	-	109	F6	117	F12	123
  2424. 	6	102	.	110	 	 	 	 
  2425. 	7	103	/	111	 	 
  2426. 	
  2427. 	控制键键码值(keyCode)
  2428. 	按键		键码	按键		键码	按键		键码	按键		键码
  2429. 	BackSpace	8	Esc		27	→		39	-_		189
  2430. 	Tab		9	Spacebar	32	↓		40	.>		190
  2431. 	Clear		12	Page Up		33	Insert		45	/?		191
  2432. 	Enter		13	Page Down	34	Delete		46	`~		192
  2433. 	Shift		16	End		35	Num Lock	144	[{		219
  2434. 	Control		17	Home		36	;:		186	\|		220
  2435. 	Alt		18	←		37	=+		187	]}		221
  2436. 	Cape Lock	20	↑		38	,<		188	'"		222
  2437.  
  2438. 	多媒体键码值(keyCode)
  2439. 	按键		键码
  2440. 	音量加		175
  2441. 	音量减		174
  2442. 	停止		179
  2443. 	静音		173
  2444. 	浏览器		172
  2445. 	邮件		180
  2446. 	搜索		170
  2447. 	收藏		171
  2448.    **/
  2449.   Utils.listenKeyPress = function (listenObj, callback) {
  2450.     if (!(listenObj instanceof Window) && !Utils.isDOM(listenObj)) {
  2451.       throw new Error(
  2452.         "Utils.listenKeyPress 参数 listenObj 必须为 Window|Node 类型"
  2453.       );
  2454.     }
  2455.     listenObj.addEventListener("keypress", function (event) {
  2456.       let keyName = event.code || event.key;
  2457.       let otherCodeList = [];
  2458.       if (event.ctrlKey) {
  2459.         otherCodeList = [...otherCodeList, "ctrl"];
  2460.       }
  2461.       if (event.altKey) {
  2462.         otherCodeList = [...otherCodeList, "alt"];
  2463.       }
  2464.       if (event.metaKey) {
  2465.         otherCodeList = [...otherCodeList, "meta"];
  2466.       }
  2467.       if (event.shiftKey) {
  2468.         otherCodeList = [...otherCodeList, "shift"];
  2469.       }
  2470.       if (typeof callback === "function") {
  2471.         callback(keyName, otherCodeList, event);
  2472.       }
  2473.     });
  2474.   };
  2475.  
  2476.   /**
  2477.    * 日志对象
  2478.    * @param {Function} _GM_info_ 油猴管理器的API GM_info
  2479.    * @example
  2480.     let log = new Utils.Log(GM_info);
  2481.     log.info("普通输出");
  2482.     > 普通输出
  2483.  
  2484.     log.success("成功输出");
  2485.     > 成功输出
  2486.  
  2487.     log.error("错误输出");
  2488.     > 错误输出
  2489.  
  2490.     log.tag = "自定义tag信息";
  2491.     log.info("自定义info的颜色","#e0e0e0");
  2492.     > 自定义info的颜色
  2493.  
  2494.     log.config({
  2495.       successColor: "#31dc02",
  2496.       errorColor: "#e02d2d",
  2497.       infoColor: "black",
  2498.     })
  2499.     log.success("颜色为#31dc02");
  2500.     > 颜色为#31dc02
  2501.    */
  2502.   Utils.Log = function (_GM_info_) {
  2503.     if (typeof _GM_info_ !== "object") {
  2504.       throw new Error(
  2505.         'Utils.Log 请添加@grant GM_info且传入该参数,如果使用"use strict"; 就无法获取caller'
  2506.       );
  2507.     }
  2508.     let msgColorDetails = [
  2509.       "font-weight: bold; color: cornflowerblue",
  2510.       "font-weight: bold; color: cornflowerblue",
  2511.       "font-weight: bold; color: darkorange",
  2512.       "font-weight: bold; color: cornflowerblue",
  2513.     ];
  2514.     let details = {
  2515.       successColor: "blue" /* 成功颜色 */,
  2516.       errorColor: "red" /* 错误颜色 */,
  2517.       infoColor: "0" /* 信息颜色 */,
  2518.       debug: false /* 开启debug模式，会在控制台输出调用者位置 */,
  2519.       autoClearConsole: false /* 当console输出超过logMaxCount数量自动清理控制台 */,
  2520.       logMaxCount: 999 /* console输出的最高数量，autoClearConsole开启则生效 */,
  2521.     };
  2522.     let logCount = 0;
  2523.     /**
  2524.      * 解析Error的堆栈获取调用者所在的函数位置
  2525.      * @param {list} stack
  2526.      */
  2527.     let parseErrorStack = function (stack) {
  2528.       let result = {
  2529.         functionName: "",
  2530.         functionPosition: "",
  2531.       };
  2532.       for (let i = 0; i < stack.length; i++) {
  2533.         let stackString = stack[i].trim();
  2534.         let stackFunctionName = stackString.match(/^at[\s]+(.+?)[\s]+/i);
  2535.         let stackFunctionNamePosition = stackString.match(
  2536.           /^at[\s]+.+[\s]+\((.+?)\)/i
  2537.         );
  2538.         if (stackFunctionName == null) {
  2539.           continue;
  2540.         }
  2541.         stackFunctionName = stackFunctionName[stackFunctionName.length - 1];
  2542.         stackFunctionNamePosition =
  2543.           stackFunctionNamePosition[stackFunctionNamePosition.length - 1];
  2544.         if (
  2545.           stackFunctionName === "" ||
  2546.           stackFunctionName.match(
  2547.             new RegExp(
  2548.               "(^Utils.Log.|.<anonymous>$|^Function.each|^NodeList.forEach|^k.fn.init.each)",
  2549.               "g"
  2550.             )
  2551.           )
  2552.         ) {
  2553.           continue;
  2554.         } else {
  2555.           result.functionName = stackFunctionName;
  2556.           result.functionPosition = stackFunctionNamePosition;
  2557.           break;
  2558.         }
  2559.       }
  2560.       return result;
  2561.     };
  2562.     /* 待恢复的函数或对象 */
  2563.     let recoveryList = [];
  2564.     /**
  2565.      * 检测清理控制台
  2566.      * @this {this}
  2567.      */
  2568.     let checkClearConsole = function () {
  2569.       logCount++;
  2570.       if (details.autoClearConsole && logCount > details.logMaxCount) {
  2571.         console.clear();
  2572.         logCount = 0;
  2573.       }
  2574.     };
  2575.     this.tag = _GM_info_?.script?.name || "GM_info缺失";
  2576.     /**
  2577.      * 控制台-普通输出
  2578.      * @param {any} msg
  2579.      * @param {String} color
  2580.      * @param {String} type
  2581.      */
  2582.     this.info = function (msg, color, type = "info") {
  2583.       checkClearConsole.apply(this);
  2584.       let stack = new Error().stack.split("\n");
  2585.       if (type === "info") {
  2586.         color = color || details.infoColor;
  2587.       }
  2588.       stack.splice(0, 1);
  2589.       let errorStackParse = parseErrorStack(stack);
  2590.       let stackFunctionName = errorStackParse["functionName"];
  2591.       let stackFunctionNamePosition = errorStackParse["functionPosition"];
  2592.       let callerName = stackFunctionName;
  2593.       if (typeof msg === "object") {
  2594.         console.log(
  2595.           `%c[${this.tag}%c-%c${callerName}%c]%c `,
  2596.           ...msgColorDetails,
  2597.           `color: ${color}`,
  2598.           msg
  2599.         );
  2600.       } else {
  2601.         console.log(
  2602.           `%c[${this.tag}%c-%c${callerName}%c]%c ${msg}`,
  2603.           ...msgColorDetails,
  2604.           `color: ${color}`
  2605.         );
  2606.       }
  2607.       if (details.debug) {
  2608.         console.log(stackFunctionNamePosition);
  2609.       }
  2610.     };
  2611.     /**
  2612.      * 控制台-错误输出
  2613.      * @param {any} msg
  2614.      * @param {string} color
  2615.      */
  2616.     this.error = function (msg, color) {
  2617.       this.info(msg, color || details.errorColor, "error");
  2618.     };
  2619.     /**
  2620.      * 控制台-成功输出
  2621.      * @param {any} msg
  2622.      * @param {string} color
  2623.      */
  2624.     this.success = function (msg, color) {
  2625.       this.info(msg, color || details.successColor, "success");
  2626.     };
  2627.     /**
  2628.      * 控制台-输出表格
  2629.      * @param {object} msgObj
  2630.      * @example
  2631.      * log.table([{"名字":"example","值":"123"},{"名字":"example2","值":"345"}])
  2632.      */
  2633.     this.table = function (msgObj) {
  2634.       checkClearConsole.apply(this);
  2635.       let stack = new Error().stack.split("\n");
  2636.       if (type === "info") {
  2637.         color = color || details.infoColor;
  2638.       }
  2639.       stack.splice(0, 1);
  2640.       let errorStackParse = parseErrorStack(stack);
  2641.       let stackFunctionName = errorStackParse["functionName"];
  2642.       let stackFunctionNamePosition = errorStackParse["functionPosition"];
  2643.       let callerName = stackFunctionName;
  2644.       console.log(
  2645.         `%c[${this.tag}%c-%c${callerName}%c]%c`,
  2646.         ...msgColorDetails,
  2647.         `color: ${color}`
  2648.       );
  2649.       console.table(msgObj);
  2650.       if (details.debug) {
  2651.         console.log(stackFunctionNamePosition);
  2652.       }
  2653.     };
  2654.     /**
  2655.      * 配置Log对象的颜色
  2656.      * @param {object} paramDetails 配置信息
  2657.      */
  2658.     this.config = function (paramDetails) {
  2659.       details = Object.assign(details, paramDetails);
  2660.     };
  2661.     /**
  2662.      * 禁用输出
  2663.      */
  2664.     this.disable = function () {
  2665.       let that = this;
  2666.       Object.keys(this)
  2667.         .filter((keyName) => Boolean(keyName.match(/info|error|success|table/)))
  2668.         .forEach((keyName) => {
  2669.           let value = {};
  2670.           value[keyName] = that[keyName];
  2671.           recoveryList = [...recoveryList, value];
  2672.           that[keyName] = () => {};
  2673.         });
  2674.     };
  2675.     /**
  2676.      * 恢复输出
  2677.      */
  2678.     this.recovery = function () {
  2679.       let that = this;
  2680.       recoveryList.forEach((item) => {
  2681.         let keyName = Object.keys(item);
  2682.         that[keyName] = item[keyName];
  2683.       });
  2684.       recoveryList = [];
  2685.     };
  2686.   };
  2687.  
  2688.   /**
  2689.    * 合并数组内的JSON的值字符串
  2690.    * @param {[...any]} data 需要合并的数组
  2691.    * @param {Function|string|undefined} handleFunc 处理的函数|JSON的key
  2692.    * @returns {string}
  2693.    * @example
  2694.    * Utils.mergeArrayToString([{"name":"数组内数据部分字段合并成字符串->"},{"name":"mergeToString"}],(item)=>{return item["name"]});
  2695.    * > '数组内数据部分字段合并成字符串->mergeToString'
  2696.    **/
  2697.   Utils.mergeArrayToString = function (data, handleFunc) {
  2698.     if (!(data instanceof Array)) {
  2699.       throw new Error("Utils.mergeArrayToString 参数 data 必须为 Array 类型");
  2700.     }
  2701.     let content = "";
  2702.     if (typeof handleFunc === "function") {
  2703.       data.forEach((item) => {
  2704.         content += handleFunc(item);
  2705.       });
  2706.     } else if (typeof handleFunc === "string") {
  2707.       data.forEach((item) => {
  2708.         content += item[handleFunc];
  2709.       });
  2710.     } else {
  2711.       data.forEach((item) => {
  2712.         Object.values(item)
  2713.           .filter((item2) => typeof item2 === "string")
  2714.           .forEach((item3) => {
  2715.             content += item3;
  2716.           });
  2717.       });
  2718.     }
  2719.     return content;
  2720.   };
  2721.  
  2722.   /**
  2723.    * 监听页面元素改变并处理
  2724.    * @param {object|Node|HTMLElement} target 需要监听的元素，如果不存在，可以等待它出现
  2725.    * @param {object} observer_config MutationObserver的配置
  2726.    * @example
  2727.     Utils.mutationObserver(document.querySelector("div.xxxx"),{
  2728.       "callback":(mutations, observer)=>{},
  2729.       "config":{childList:true,attributes:true}
  2730.     });
  2731.    * @example
  2732.     Utils.mutationObserver(document.querySelectorAll("div.xxxx"),{
  2733.       "callback":(mutations, observer)=>{},
  2734.       "config":{childList:true,attributes:true}}
  2735.     );
  2736.    * @example
  2737.     Utils.mutationObserver($("div.xxxx"),{
  2738.     "callback":(mutations, observer)=>{},
  2739.     "config":{childList:true,attributes:true}}
  2740.     );
  2741.    **/
  2742.   Utils.mutationObserver = function (target, observer_config) {
  2743.     if (
  2744.       !(target instanceof Node) &&
  2745.       !(target instanceof NodeList) &&
  2746.       !Utils.isJQuery(target)
  2747.     ) {
  2748.       throw new Error(
  2749.         "Utils.mutationObserver 参数 target 必须为 Node|NodeList|jQuery类型"
  2750.       );
  2751.     }
  2752.  
  2753.     let default_obverser_config = {
  2754.       /* 监听到元素有反馈，需执行的函数 */
  2755.       callback: () => {},
  2756.       config: {
  2757.         /* 当为 true 时，将会监听以 target 为根节点的整个子树。包括子树中所有节点的属性，而不仅仅是针对 target。默认值为 false */
  2758.         subtree: undefined,
  2759.         /* 当为 true 时，监听 target 节点中发生的节点的新增与删除（同时，如果 subtree 为 true，会针对整个子树生效）。默认值为 false。 */
  2760.         childList: undefined,
  2761.         /* 当为 true 时观察所有监听的节点属性值的变化。默认值为 true，当声明了 attributeFilter 或 attributeOldValue，默认值则为 false */
  2762.         attributes: undefined,
  2763.         /* 一个用于声明哪些属性名会被监听的数组。如果不声明该属性，所有属性的变化都将触发通知 */
  2764.         attributeFilter: undefined,
  2765.         /* 当为 true 时，记录上一次被监听的节点的属性变化；可查阅 MutationObserver 中的 Monitoring attribute values 了解关于观察属性变化和属性值记录的详情。默认值为 false */
  2766.         attributeOldValue: undefined,
  2767.         /* 当为 true 时，监听声明的 target 节点上所有字符的变化。默认值为 true，如果声明了 characterDataOldValue，默认值则为 false */
  2768.         characterData: undefined,
  2769.         /* 当为 true 时，记录前一个被监听的节点中发生的文本变化。默认值为 false */
  2770.         characterDataOldValue: undefined,
  2771.       },
  2772.     };
  2773.     observer_config = Utils.assign(default_obverser_config, observer_config);
  2774.     let MutationObserver =
  2775.       window.MutationObserver ||
  2776.       window.webkitMutationObserver ||
  2777.       window.MozMutationObserver;
  2778.     let mutationObserver = new MutationObserver(function (mutations, observer) {
  2779.       observer_config?.callback(mutations, observer);
  2780.     });
  2781.     if (target instanceof Node) {
  2782.       /* 传入的参数是节点元素 */
  2783.       mutationObserver.observe(target, observer_config.config);
  2784.     } else if (target instanceof NodeList) {
  2785.       /* 传入的参数是节点元素数组 */
  2786.       target.forEach((item) => {
  2787.         mutationObserver.observe(item, observer_config.config);
  2788.       });
  2789.     } else if (Utils.isJQuery(target)) {
  2790.       /* 传入的参数是jQuery对象 */
  2791.       target.each((index, item) => {
  2792.         mutationObserver.observe(item, observer_config.config);
  2793.       });
  2794.     } else {
  2795.       /* 未知 */
  2796.       console.error("Utils.mutationObserver 未知参数", arguments);
  2797.     }
  2798.     return mutationObserver;
  2799.   };
  2800.  
  2801.   /**
  2802.    * 去除全局window下的Utils，返回控制权
  2803.    * @returns {Utils}
  2804.    * @example
  2805.    * let utils = Utils.noConflict();
  2806.    * > ...
  2807.    */
  2808.   Utils.noConflict = function () {
  2809.     delete window[GLOBAL_NAME_SPACE];
  2810.     if (tempUtils) {
  2811.       window[GLOBAL_NAME_SPACE] = tempUtils;
  2812.     }
  2813.     return Utils;
  2814.   };
  2815.  
  2816.   /**
  2817.    * 恢复/释放该对象内的为function，让它无效/有效
  2818.    * @param {object} needReleaseObject 需要操作的对象
  2819.    * @param {string} needReleaseName 需要操作的对象的名字
  2820.    * @param {array} functionNameList 需要释放的方法，如果为空，默认全部方法
  2821.    * @param {boolean} release
  2822.    * + true (默认) 释放该对象下的某些方法
  2823.    * + false 恢复该对象下的某些方法
  2824.    * @example
  2825.     // 释放该方法
  2826.     Utils.noConflictFunc(console,"console",["log"],true);
  2827.     console.log;
  2828.     > () => {}
  2829.  
  2830.    * @example
  2831.     // 恢复该方法
  2832.     Utils.noConflictFunc(console,"console",["log"],false);
  2833.     console.log;
  2834.     > ƒ log() { [native code] }
  2835.  
  2836.    * @example
  2837.     // 释放所有方法
  2838.     Utils.noConflictFunc(console,"console",[],true);
  2839.     console.debug;
  2840.     > () => {}
  2841.  
  2842.    * @example
  2843.     // 恢复所有方法
  2844.     Utils.noConflictFunc(console,"console",[],false);
  2845.     console.debug;
  2846.     > ƒ log() { [native code] }
  2847.    **/
  2848.   Utils.noConflictFunc = function (
  2849.     needReleaseObject,
  2850.     needReleaseName,
  2851.     functionNameList = [],
  2852.     release = true
  2853.   ) {
  2854.     if (typeof needReleaseObject !== "object") {
  2855.       throw new Error(
  2856.         "Utils.noConflictFunc 参数 needReleaseObject 必须为 object 类型"
  2857.       );
  2858.     }
  2859.     if (typeof needReleaseName !== "string") {
  2860.       throw new Error(
  2861.         "Utils.noConflictFunc 参数 needReleaseName 必须为 string 类型"
  2862.       );
  2863.     }
  2864.     if (!Array.isArray(functionNameList)) {
  2865.       throw new Error(
  2866.         "Utils.noConflictFunc 参数 functionNameList 必须为 Array 类型"
  2867.       );
  2868.     }
  2869.     let needReleaseKey = "__" + needReleaseName;
  2870.     /**
  2871.      * 复制对象
  2872.      * @param {object} obj
  2873.      * @returns {object}
  2874.      */
  2875.     function cloneObj(obj) {
  2876.       let newObj = {};
  2877.       if (obj instanceof Array) {
  2878.         newObj = [];
  2879.       }
  2880.       for (let key in obj) {
  2881.         let val = obj[key];
  2882.         newObj[key] = typeof val === "object" ? cloneObj(val) : val;
  2883.       }
  2884.       return newObj;
  2885.     }
  2886.     /**
  2887.      * 释放所有
  2888.      */
  2889.     function releaseAll() {
  2890.       if (typeof window[needReleaseKey] !== "undefined") {
  2891.         /* 已存在 */
  2892.         return;
  2893.       }
  2894.       window[needReleaseKey] = cloneObj(needReleaseObject);
  2895.       Object.values(needReleaseObject).forEach((value) => {
  2896.         if (typeof value === "function") {
  2897.           needReleaseObject[value.name] = () => {};
  2898.         }
  2899.       });
  2900.     }
  2901.     /**
  2902.      * 释放单个
  2903.      */
  2904.     function releaseOne() {
  2905.       Array.from(functionNameList).forEach((item) => {
  2906.         Object.values(needReleaseObject).forEach((value) => {
  2907.           if (typeof value === "function") {
  2908.             if (typeof window[needReleaseKey] === "undefined") {
  2909.               window[needReleaseKey] = {};
  2910.             }
  2911.             if (item === value.name) {
  2912.               window[needReleaseKey][value.name] =
  2913.                 needReleaseObject[value.name];
  2914.               needReleaseObject[value.name] = () => {};
  2915.             }
  2916.           }
  2917.         });
  2918.       });
  2919.     }
  2920.     /**
  2921.      * 恢复所有
  2922.      */
  2923.     function recoveryAll() {
  2924.       if (typeof window[needReleaseKey] === "undefined") {
  2925.         /* 未存在 */
  2926.         return;
  2927.       }
  2928.       Object.assign(needReleaseObject, window[needReleaseKey]);
  2929.       delete window[needReleaseKey];
  2930.     }
  2931.  
  2932.     /**
  2933.      * 恢复单个
  2934.      */
  2935.     function recoveryOne() {
  2936.       if (typeof window[needReleaseKey] === "undefined") {
  2937.         /* 未存在 */
  2938.         return;
  2939.       }
  2940.       Array.from(functionNameList).forEach((item) => {
  2941.         if (window[needReleaseKey][item]) {
  2942.           needReleaseObject[item] = window[needReleaseKey][item];
  2943.           delete window[needReleaseKey][item];
  2944.           if (Object.keys(window[needReleaseKey]).length === 0) {
  2945.             delete window[needReleaseKey];
  2946.           }
  2947.         }
  2948.       });
  2949.     }
  2950.     if (release) {
  2951.       /* 释放 */
  2952.       if (functionNameList.length === 0) {
  2953.         releaseAll();
  2954.       } else {
  2955.         /* 对单个进行操作 */
  2956.         releaseOne();
  2957.       }
  2958.     } else {
  2959.       /* 恢复 */
  2960.       if (functionNameList.length === 0) {
  2961.         recoveryAll();
  2962.       } else {
  2963.         /* 对单个进行操作 */
  2964.         recoveryOne();
  2965.       }
  2966.     }
  2967.   };
  2968.  
  2969.   /**
  2970.    * base64转blob
  2971.    * @param {string} dataUri base64的数据
  2972.    * @return {string} blob的链接
  2973.    * @example
  2974.    * Utils.parseBase64ToBlob("data:image/jpeg;base64,.....");
  2975.    * > blob://xxxxxxx
  2976.    **/
  2977.   Utils.parseBase64ToBlob = function (dataUri) {
  2978.     if (typeof dataUri !== "string") {
  2979.       throw new Error(
  2980.         "Utils.parseBase64ToBlob 参数 dataUri 必须为 string 类型"
  2981.       );
  2982.     }
  2983.     let dataUriSplit = dataUri.split(","),
  2984.       dataUriMime = dataUriSplit[0].match(/:(.*?);/)[1],
  2985.       dataUriBase64Str = atob(dataUriSplit[1]),
  2986.       dataUriLength = dataUriBase64Str.length,
  2987.       u8arr = new Uint8Array(dataUriLength);
  2988.     while (dataUriLength--) {
  2989.       u8arr[dataUriLength] = dataUriBase64Str.charCodeAt(dataUriLength);
  2990.     }
  2991.     return new Blob([u8arr], {
  2992.       type: dataUriMime,
  2993.     });
  2994.   };
  2995.  
  2996.   /**
  2997.    * base64转File对象
  2998.    * @param {string} dataUri	base64的数据
  2999.    * @return {string}	blob的链接
  3000.    * @example
  3001.    * Utils.parseBase64ToFile("data:image/jpeg;base64,.....","测试文件");
  3002.    * > object
  3003.    **/
  3004.   Utils.parseBase64ToFile = function (dataUri, fileName) {
  3005.     if (typeof dataUri !== "string") {
  3006.       throw new Error(
  3007.         "Utils.parseBase64ToFile 参数 dataUri 必须为 string 类型"
  3008.       );
  3009.     }
  3010.     if (typeof fileName !== "string") {
  3011.       throw new Error(
  3012.         "Utils.parseBase64ToFile 参数 fileName 必须为 string 类型"
  3013.       );
  3014.     }
  3015.     let dataUriSplit = dataUri.split(","),
  3016.       dataUriMime = dataUriSplit[0].match(/:(.*?);/)[1],
  3017.       dataUriBase64Str = atob(dataUriSplit[1]),
  3018.       dataUriLength = dataUriBase64Str.length,
  3019.       u8arr = new Uint8Array(dataUriLength);
  3020.     while (dataUriLength--) {
  3021.       u8arr[dataUriLength] = dataUriBase64Str.charCodeAt(dataUriLength);
  3022.     }
  3023.     return new File([u8arr], fileName, {
  3024.       type: dataUriMime,
  3025.     });
  3026.   };
  3027.  
  3028.   /**
  3029.    * 将正则匹配到的结果取出最后一个值并转换成int格式
  3030.    * @param {[...any]} matchList 正则匹配的列表
  3031.    * @param {number|string} defaultValue 正则匹配的列表为空时，或者正则匹配的列表最后一项不为Int，返回该默认值
  3032.    * @example
  3033.    * Utils.parseInt(["dadaadada123124","123124"],0);
  3034.    * > 123124
  3035.    *
  3036.    * @example
  3037.    * Utils.parseInt(null,0);
  3038.    * > 0
  3039.    * @example
  3040.    * Utils.parseInt(["aaaaaa"]);
  3041.    * > 0
  3042.    *
  3043.    * @example
  3044.    * Utils.parseInt(["aaaaaa"],"66");
  3045.    * > 66
  3046.    *
  3047.    * @example
  3048.    * Utils.parseInt(["aaaaaaa"],"aa");
  3049.    * > NaN
  3050.    **/
  3051.   Utils.parseInt = function (matchList = [], defaultValue = 0) {
  3052.     if (matchList == null) {
  3053.       return parseInt(defaultValue);
  3054.     }
  3055.     let parseValue = parseInt(matchList[matchList.length - 1]);
  3056.     if (isNaN(parseValue)) {
  3057.       parseValue = parseInt(defaultValue);
  3058.     }
  3059.     return parseValue;
  3060.   };
  3061.  
  3062.   /**
  3063.    * blob转File对象
  3064.    * @param {string} blobUrl	需要转换的blob的链接
  3065.    * @param {string} fileName	转换成的File对象的文件名称
  3066.    * @return {object} File对象
  3067.    * @example
  3068.    * Utils.blobToFile("blob://xxxxx");
  3069.    * > object
  3070.    **/
  3071.   Utils.parseBlobToFile = function (blobUrl, fileName) {
  3072.     const file = new File([blob], fileName, { type: blob.type });
  3073.     return new Promise((resolve, reject) => {
  3074.       fetch(blobUrl)
  3075.         .then((response) => response.blob())
  3076.         .then((blob) => {
  3077.           const file = blobToFile(blob, "example.txt");
  3078.           resolve(file);
  3079.         })
  3080.         .catch((error) => {
  3081.           console.error("Error:", error);
  3082.           reject(error);
  3083.         });
  3084.     });
  3085.   };
  3086.  
  3087.   /**
  3088.    * 【异步函数】File对象转base64
  3089.    * @param {object} fileObj	需要转换的File对象
  3090.    * @return {string} base64格式的数据
  3091.    * @example
  3092.    * await Utils.parseFileToBase64(object);
  3093.    * > 'data:image/jpeg:base64/,xxxxxx'
  3094.    **/
  3095.   Utils.parseFileToBase64 = async function (fileObj) {
  3096.     let reader = new FileReader();
  3097.     reader.readAsDataURL(fileObj);
  3098.     return new Promise((resolve) => {
  3099.       reader.onload = function (event) {
  3100.         resolve(event.target.result);
  3101.       };
  3102.     });
  3103.   };
  3104.  
  3105.   /**
  3106.    * 解析字符串
  3107.    * @param {string} text 要解析的 DOMString。它必须包含 HTML、xml、xhtml+xml 或 svg 文档。
  3108.    * @param {string} mimeType 解析成的类型，包括：text/html、text/xml、application/xml、application/xhtml+xml、image/svg+xml
  3109.    * @returns {HTMLElement|XMLDocument|SVGElement}
  3110.    * @example
  3111.    * Utils.parseFromString("<p>123<p>");
  3112.    * > #document
  3113.    */
  3114.   Utils.parseFromString = function (text, mimeType = "text/html") {
  3115.     let parser = new DOMParser();
  3116.     return parser.parseFromString(text, mimeType);
  3117.   };
  3118.  
  3119.   /**
  3120.    * 在canvas元素节点上绘制进度圆圈
  3121.    * @param {object} paramConfig 配置信息
  3122.    * @example
  3123.     let progress = new Utils.Process({canvasNode:document.querySelector("canvas")});
  3124.     progress.draw();
  3125.    * **/
  3126.   Utils.Progress = function (paramConfig) {
  3127.     this.config = {
  3128.       canvasNode: null /* canvas元素节点 */,
  3129.       deg: 95 /* 绘制角度 */,
  3130.       progress: 0 /* 进度 */,
  3131.       lineWidth: 10 /* 绘制的线宽度 */,
  3132.       lineBgColor: "#1e637c" /* 绘制的背景颜色 */,
  3133.       lineColor: "#25deff",
  3134.       textColor: "#000000" /* 文字的颜色 */,
  3135.       fontSize: 22 /* 字体大小(px) */,
  3136.       circleRadius: 50 /* 圆半径 */,
  3137.       draw: () => {} /* 控制绘制 */,
  3138.     };
  3139.     this.config = Utils.assign(this.config, paramConfig);
  3140.     if (!(this.config.canvasNode instanceof HTMLCanvasElement)) {
  3141.       throw new Error(
  3142.         "Utils.Progress 参数 canvasNode 必须是 HTMLCanvasElement"
  3143.       );
  3144.     }
  3145.     let ctx = this.config.canvasNode.getContext("2d"); /* 获取画笔 */
  3146.     let width = this.config.canvasNode.width; /* 元素宽度 */
  3147.     let height = this.config.canvasNode.height; /* 元素高度 */
  3148.  
  3149.     /* 清除锯齿 */
  3150.     if (window.devicePixelRatio) {
  3151.       this.config.canvasNode.style.width = width + "px";
  3152.       this.config.canvasNode.style.height = height + "px";
  3153.       this.config.canvasNode.height = height * window.devicePixelRatio;
  3154.       this.config.canvasNode.width = width * window.devicePixelRatio;
  3155.       ctx.scale(window.devicePixelRatio, window.devicePixelRatio);
  3156.     }
  3157.     /* 设置线宽 */
  3158.     ctx.lineWidth = this.config.lineWidth;
  3159.     /* 绘制 */
  3160.     this.draw = function () {
  3161.       let degActive = (this.config.progress * 360) / 100;
  3162.       ctx.clearRect(0, 0, width, height); //清除画布
  3163.       ctx.beginPath(); //开始绘制底圆
  3164.       ctx.arc(width / 2, height / 2, this.config.circleRadius, 1, 8);
  3165.       ctx.strokeStyle = this.config.lineBgColor;
  3166.       ctx.stroke();
  3167.       ctx.beginPath(); //开始绘制动态圆
  3168.       ctx.arc(
  3169.         width / 2,
  3170.         height / 2,
  3171.         this.config.circleRadius,
  3172.         -Math.PI / 2,
  3173.         (degActive * Math.PI) / 180 - Math.PI / 2
  3174.       );
  3175.       ctx.strokeStyle = this.config.lineColor;
  3176.       ctx.stroke();
  3177.       let txt = parseInt(this.config.progress) + "%"; //获取百分比
  3178.       ctx.font = this.config.fontSize + "px SimHei";
  3179.       let w = ctx.measureText(txt).width; //获取文本宽度
  3180.       let h = this.config.fontSize / 2;
  3181.       ctx.fillStyle = this.config.textColor;
  3182.       ctx.fillText(txt, width / 2 - w / 2, height / 2 + h / 2);
  3183.     }.bind(this);
  3184.   };
  3185.  
  3186.   /**
  3187.    * 复制到剪贴板
  3188.    * @param {string|number} text - 需要复制到剪贴板的文本
  3189.    * @example
  3190.    * Utils.setClip("xxxx");
  3191.    **/
  3192.   Utils.setClip = function (text) {
  3193.     if (typeof text !== "string" && typeof text !== "number") {
  3194.       console.error(typeof text);
  3195.       throw new Error("复制的貌似不是string或number类型");
  3196.     }
  3197.     // 获取剪贴板对象
  3198.     const clipboard = navigator.clipboard;
  3199.  
  3200.     // 复制文本到剪贴板
  3201.     clipboard
  3202.       .writeText(text)
  3203.       .then(() => {
  3204.         console.log("复制成功");
  3205.       })
  3206.       .catch((err) => {
  3207.         console.error("复制失败，使用第二种方式", err);
  3208.         let chipBoardNode = document.createElement("input");
  3209.         chipBoardNode.type = "text";
  3210.         chipBoardNode.setAttribute("style", "opacity:0;position:absolute;");
  3211.         chipBoardNode.id = "whitesevClipBoardInput";
  3212.         document.body.append(chipBoardNode);
  3213.         let clipBoardInputNode = document.querySelector(
  3214.           "#whitesevClipBoardInput"
  3215.         );
  3216.         clipBoardInputNode.value = text;
  3217.         clipBoardInputNode.removeAttribute("disabled");
  3218.         clipBoardInputNode.select();
  3219.         document.execCommand("copy");
  3220.         clipBoardInputNode.remove();
  3221.       });
  3222.   };
  3223.  
  3224.   /**
  3225.    * 【异步函数】等待N秒执行函数
  3226.    * @param {Function|string} func	待执行的函数(字符串)
  3227.    * @param {number} delayTime	延时时间(ms)
  3228.    * @return {?undefined}	函数的返回值
  3229.    * @example
  3230.    * await Utils.setTimeout(()=>{}, 2500);
  3231.    * > ƒ tryCatchObj() {}
  3232.    * @example
  3233.    * await Utils.setTimeout("()=>{console.log(12345)}", 2500);
  3234.    * > ƒ tryCatchObj() {}
  3235.    **/
  3236.   Utils.setTimeout = async function (func, delayTime = 0) {
  3237.     if (typeof func !== "function" && typeof func !== "string") {
  3238.       throw new Error("Utils.setTimeout 参数 func 必须为 function|string 类型");
  3239.     }
  3240.     if (typeof delayTime !== "number") {
  3241.       throw new Error("Utils.setTimeout 参数 delayTime 必须为 number 类型");
  3242.     }
  3243.     return new Promise((resolve) => {
  3244.       setTimeout(() => {
  3245.         resolve(Utils.tryCatch().run(func));
  3246.       }, delayTime);
  3247.     });
  3248.   };
  3249.  
  3250.   /**
  3251.    * 【异步函数】延迟xxx毫秒
  3252.    * @param {number} delayTime 延时时间(ms)
  3253.    * @example
  3254.    * await Utils.sleep(2500)
  3255.    **/
  3256.   Utils.sleep = async function (delayTime) {
  3257.     if (typeof delayTime !== "number") {
  3258.       throw new Error("Utils.sleep 参数 delayTime 必须为 number 类型");
  3259.     }
  3260.     return new Promise((resolve) => {
  3261.       setTimeout(() => {
  3262.         resolve();
  3263.       }, delayTime);
  3264.     });
  3265.   };
  3266.  
  3267.   /**
  3268.    * 数组按照内部某个值的大小比对排序，如[{"time":"2022-1-1"},{"time":"2022-2-2"}]
  3269.    * @param {Array|NodeList|Function} data 数据|获取数据的方法
  3270.    * @param {string|Function} getPropertyValueFunc 数组内部项的某个属性的值的方法，参数为这个项
  3271.    * @param {boolean} sortByDesc 排序方式，默认true倒序(值最大排第一个，如:6、5、4、3...)，false为升序(值最小排第一个，如:1、2、3、4...)
  3272.    * @return {object} 返回比较排序完成的数组
  3273.    * @example
  3274.    * Utils.sortListByProperty([{"time":"2022-1-1"},{"time":"2022-2-2"}],(item)=>{return item["time"]})
  3275.    * > [{time: '2022-2-2'},{time: '2022-1-1'}]
  3276.    * @example
  3277.    * Utils.sortListByProperty([{"time":"2022-1-1"},{"time":"2022-2-2"}],(item)=>{return item["time"]},false)
  3278.    * > [{time: '2022-1-1'},{time: '2022-2-2'}]
  3279.    **/
  3280.   Utils.sortListByProperty = function (
  3281.     data,
  3282.     getPropertyValueFunc,
  3283.     sortByDesc = true
  3284.   ) {
  3285.     if (
  3286.       typeof getPropertyValueFunc !== "function" &&
  3287.       typeof getPropertyValueFunc !== "string"
  3288.     ) {
  3289.       throw new Error(
  3290.         "Utils.sortListByProperty 参数 getPropertyValueFunc 必须为 function|string 类型"
  3291.       );
  3292.     }
  3293.     if (typeof sortByDesc !== "boolean") {
  3294.       throw new Error(
  3295.         "Utils.sortListByProperty 参数 sortByDesc 必须为 boolean 类型"
  3296.       );
  3297.     }
  3298.     let getObjValue = function (obj) {
  3299.       return typeof getPropertyValueFunc === "string"
  3300.         ? obj[getPropertyValueFunc]
  3301.         : getPropertyValueFunc(obj);
  3302.     };
  3303.     /**
  3304.      * 排序方法
  3305.      * @param {any} after_obj
  3306.      * @param {any} before_obj
  3307.      * @returns
  3308.      */
  3309.     let sortFunc = function (after_obj, before_obj) {
  3310.       let beforeValue = getObjValue(before_obj); /*  前 */
  3311.       let afterValue = getObjValue(after_obj); /* 后 */
  3312.       if (sortByDesc) {
  3313.         if (afterValue > beforeValue) {
  3314.           return -1;
  3315.         } else if (afterValue < beforeValue) {
  3316.           return 1;
  3317.         } else {
  3318.           return 0;
  3319.         }
  3320.       } else {
  3321.         if (afterValue < beforeValue) {
  3322.           return -1;
  3323.         } else if (afterValue > beforeValue) {
  3324.           return 1;
  3325.         } else {
  3326.           return 0;
  3327.         }
  3328.       }
  3329.     };
  3330.     /**
  3331.      * 排序元素方法
  3332.      * @param {NodeList|jQuery} nodeList 元素列表
  3333.      * @param {Function} getNodeListFunc 获取元素列表的函数
  3334.      */
  3335.     let sortNodeFunc = function (nodeList, getNodeListFunc) {
  3336.       let nodeListLength = nodeList.length;
  3337.       for (let i = 0; i < nodeListLength - 1; i++) {
  3338.         for (let j = 0; j < nodeListLength - 1 - i; j++) {
  3339.           let beforeNode = nodeList[j];
  3340.           let afterNode = nodeList[j + 1];
  3341.           let beforeValue = getObjValue(beforeNode); /*  前 */
  3342.           let afterValue = getObjValue(afterNode); /* 后 */
  3343.           if (
  3344.             (sortByDesc == true && beforeValue < afterValue) ||
  3345.             (sortByDesc == false && beforeValue > afterValue)
  3346.           ) {
  3347.             /* 升序/降序 */
  3348.             /* 相邻元素两两对比 */
  3349.             let temp = beforeNode.nextElementSibling;
  3350.             afterNode.after(beforeNode);
  3351.             if (temp == null) {
  3352.               /* 如果为空，那么是最后一个元素，使用append */
  3353.               temp.parentNode.appendChild(afterNode);
  3354.             } else {
  3355.               /* 不为空，使用before */
  3356.               temp.before(afterNode);
  3357.             }
  3358.             nodeList = getNodeListFunc();
  3359.           }
  3360.         }
  3361.       }
  3362.     };
  3363.     let result = data;
  3364.     let getDataFunc = null;
  3365.     if (data instanceof Function) {
  3366.       getDataFunc = data;
  3367.       data = data();
  3368.     }
  3369.     if (Array.isArray(data)) {
  3370.       data.sort(sortFunc);
  3371.     } else if (data instanceof NodeList || Utils.isJQuery(data)) {
  3372.       sortNodeFunc(data, getDataFunc);
  3373.       result = getDataFunc();
  3374.     } else {
  3375.       throw new Error(
  3376.         "Utils.sortListByProperty 参数 data 必须为 Array|NodeList|jQuery 类型"
  3377.       );
  3378.     }
  3379.     return result;
  3380.   };
  3381.  
  3382.   /**
  3383.    * 字符串转Object对象，类似'{"test":""}' => {"test":""}
  3384.    * @param {string} data
  3385.    * @returns {object}
  3386.    * @example
  3387.    * Utils.toJSON("{123:123}")
  3388.    * > {123:123}
  3389.    */
  3390.   Utils.toJSON = function (data) {
  3391.     let result = {};
  3392.     Utils.tryCatch()
  3393.       .config({ log: false })
  3394.       .error(() => {
  3395.         Utils.tryCatch().run(() => {
  3396.           result = window.eval("(" + data + ")");
  3397.         });
  3398.       })
  3399.       .run(() => {
  3400.         result = JSON.parse(data);
  3401.       });
  3402.     return result;
  3403.   };
  3404.  
  3405.   /**
  3406.    * 提供一个封装了 try-catch 的函数，可以执行传入的函数并捕获其可能抛出的错误，并通过传入的错误处理函数进行处理。
  3407.    * @return {{run:Function,config:Function,error:Function}} - 返回一个对象，其中包含 error 和 run 两个方法。
  3408.    * @example
  3409.    * Utils.tryCatch().error().run(()=>{console.log(1)});
  3410.    * > 1
  3411.    * @example
  3412.    * Utils.tryCatch().error().run(()=>{throw new Error('测试错误')});
  3413.    * > ()=>{throw new Error('测试错误')}出现错误
  3414.    */
  3415.   Utils.tryCatch = function () {
  3416.     // 定义变量和函数
  3417.     let func = null;
  3418.     let funcThis = null;
  3419.     let handleErrorFunc = null;
  3420.     let defaultDetails = {
  3421.       log: true,
  3422.     };
  3423.     let funcArgs = arguments;
  3424.     /**
  3425.      * @function tryCatchObj
  3426.      * @description 空函数，用于链式调用。
  3427.      */
  3428.     function tryCatchObj() {}
  3429.  
  3430.     /**
  3431.      * 配置
  3432.      * @param {object} paramDetails
  3433.      */
  3434.     tryCatchObj.config = function (paramDetails) {
  3435.       defaultDetails = Utils.assign(defaultDetails, paramDetails);
  3436.       return tryCatchObj;
  3437.     };
  3438.     /**
  3439.      * 设置错误处理函数。
  3440.      * @param {function|string} handler - 错误处理函数，可以是 function 或者 string 类型。如果是 string 类型，则会被当做代码进行执行。
  3441.      * @return {function} - 返回 tryCatchObj 函数。
  3442.      */
  3443.     tryCatchObj.error = function (handler) {
  3444.       handleErrorFunc = handler;
  3445.       return tryCatchObj;
  3446.     };
  3447.  
  3448.     /**
  3449.      * 执行传入的函数并捕获其可能抛出的错误，并通过传入的错误处理函数进行处理。
  3450.      * @param {function|string} fn - 待执行函数，可以是 function 或者 string 类型。如果是 string 类型，则会被当做代码进行执行。
  3451.      * @param {object|null} fnThis - 待执行函数的作用域，用于apply指定
  3452.      * @return {any|function} - 如果函数有返回值，则返回该返回值；否则返回 tryCatchObj 函数以支持链式调用。
  3453.      * @throws {Error} - 如果传入参数不符合要求，则会抛出相应类型的错误。
  3454.      */
  3455.     tryCatchObj.run = function (fn, fnThis) {
  3456.       func = fn;
  3457.       funcThis = fnThis;
  3458.       let result = executeTryCatch(func, handleErrorFunc, funcThis);
  3459.       return result !== undefined ? result : tryCatchObj;
  3460.     };
  3461.  
  3462.     /**
  3463.      * 执行传入的函数并捕获其可能抛出的错误，并通过传入的错误处理函数进行处理。
  3464.      * @param {function|string} func - 待执行函数，可以是 function 或者 string 类型。如果是 string 类型，则会被当做代码进行执行。
  3465.      * @param {function|string|null} handleErrorFunc - 错误处理函数，可以是 function 或者 string 类型。如果是 string 类型，则会被当做代码进行执行。
  3466.      * @param {object|null} funcThis - 待执行函数的作用域，用于apply指定
  3467.      * @return {any|undefined} - 如果函数有返回值，则返回该返回值；否则返回 undefined。
  3468.      */
  3469.     function executeTryCatch(func, handleErrorFunc, funcThis) {
  3470.       let result = undefined;
  3471.       try {
  3472.         if (typeof func === "string") {
  3473.           window.eval(func);
  3474.         } else {
  3475.           result = func.apply(funcThis, funcArgs);
  3476.         }
  3477.       } catch (error) {
  3478.         if (defaultDetails.log) {
  3479.           console.log(
  3480.             `%c ${func?.name ? func?.name : func + "出现错误"} `,
  3481.             "color: #f20000"
  3482.           );
  3483.           console.log(`%c 错误原因：${error}`, "color: #f20000");
  3484.           console.trace(func);
  3485.         }
  3486.         if (handleErrorFunc) {
  3487.           if (typeof handleErrorFunc === "string") {
  3488.             result = window.eval(handleErrorFunc);
  3489.           } else {
  3490.             result = handleErrorFunc.apply(funcThis, funcArgs);
  3491.           }
  3492.         }
  3493.       }
  3494.       return result;
  3495.     }
  3496.  
  3497.     // 返回 tryCatchObj 函数
  3498.     return tryCatchObj;
  3499.   };
  3500.  
  3501.   /**
  3502.    * 数组去重，去除重复的值
  3503.    * @param {[...any]} uniqueArrayData 需要去重的数组
  3504.    * @param {[...any]} compareArrayData 用来比较的数组
  3505.    * @param {function} compareFun 数组比较方法，如果值相同，去除该数据
  3506.    * @returns {object} 返回去重完毕的数组
  3507.    * @example
  3508.    * Utils.uniqueArray([1,2,3],[1,2],(item,item2)=>{return item===item2 ? true:false});
  3509.    * > [3]
  3510.    *
  3511.    * @example
  3512.    * Utils.uniqueArray([1,2,3],[1,2]);
  3513.    * > [3]
  3514.    *
  3515.    * @example
  3516.    * Utils.uniqueArray([{"key":1,"value":2},{"key":2}],[{"key":1}],(item,item2)=>{return item["key"] === item2["key"] ? true:false});
  3517.    * > [{"key": 2}]
  3518.    **/
  3519.   Utils.uniqueArray = function (
  3520.     uniqueArrayData = [],
  3521.     compareArrayData = [],
  3522.     compareFun = (item, item2) => {
  3523.       return item === item2;
  3524.     }
  3525.   ) {
  3526.     return Array.from(uniqueArrayData).filter(
  3527.       (item) =>
  3528.         !Array.from(compareArrayData).some(function (item2) {
  3529.           return compareFun(item, item2);
  3530.         })
  3531.     );
  3532.   };
  3533.  
  3534.   /**
  3535.    * 等待函数数组全部执行完毕，注意，每个函数的顺序不是同步
  3536.    * @param {[...any] | [...HTMLElement]} data	需要遍历的数组
  3537.    * @param {Function} handleFunc	对该数组进行操作的函数，该函数的参数为数组格式的参数,[数组下标，数组项]
  3538.    * @example
  3539.    * await Utils.waitArrayLoopToEnd([func,func,func],xxxFunction);
  3540.    **/
  3541.   Utils.waitArrayLoopToEnd = function (data, handleFunc) {
  3542.     if (typeof handleFunc !== "function" && typeof handleFunc !== "string") {
  3543.       throw new Error(
  3544.         "Utils.waitArrayLoopToEnd 参数 handleDataFunction 必须为 function|string 类型"
  3545.       );
  3546.     }
  3547.     return Promise.all(
  3548.       Array.from(data).map(async (item, index) => {
  3549.         await Utils.tryCatch(index, item).run(handleFunc);
  3550.       })
  3551.     );
  3552.   };
  3553.  
  3554.   /**
  3555.    * 等待指定节点出现，支持多个 selector
  3556.    * @param {...string} nodeSelectors - 一个或多个节点选择器，必须为字符串类型
  3557.    * @returns {Promise} 返回一个 Promise 对象，成功时返回节点数组，如[ [...nodes], [...nodes] ]
  3558.    * 如果参数 nodeSelectors 只有一个的话，返回 [...nodes]
  3559.    * @example
  3560.     Utils.waitNode("div.xxx","a.xxx").then( (nodeList)=>{
  3561.       let divNodesList = nodeList[0];
  3562.       let aNodeList = nodeList[1];
  3563.     })
  3564.    */
  3565.   Utils.waitNode = function (...nodeSelectors) {
  3566.     /* 检查每个参数是否为字符串类型 */
  3567.     for (const nodeSelector of nodeSelectors) {
  3568.       if (typeof nodeSelector !== "string") {
  3569.         throw new Error("Utils.waitNode 参数必须为 ...string 类型");
  3570.       }
  3571.     }
  3572.  
  3573.     return new Promise((resolve) => {
  3574.       /* 防止触发第二次回调 */
  3575.       let isReturn = false;
  3576.  
  3577.       /* 检查所有选择器是否匹配到节点 */
  3578.       const checkNodes = () => {
  3579.         const selectNodes = nodeSelectors.map((selector) => [
  3580.           ...document.querySelectorAll(selector),
  3581.         ]);
  3582.         if (selectNodes.flat().length !== 0) {
  3583.           if (!isReturn) {
  3584.             isReturn = true;
  3585.             if (nodeSelectors.length === 1) {
  3586.               resolve(selectNodes.flat());
  3587.             } else {
  3588.               resolve(selectNodes);
  3589.             }
  3590.           }
  3591.         }
  3592.       };
  3593.  
  3594.       /* 在函数开始时检查节点是否已经存在 */
  3595.       checkNodes();
  3596.  
  3597.       /* 监听 DOM 的变化，直到至少有一个节点被匹配到 */
  3598.       Utils.mutationObserver(document.documentElement, {
  3599.         config: { subtree: true, childList: true, attributes: true },
  3600.         callback: (mutations, observer) => {
  3601.           checkNodes();
  3602.           if (isReturn) {
  3603.             observer.disconnect();
  3604.           }
  3605.         },
  3606.       });
  3607.     });
  3608.   };
  3609.  
  3610.   window[GLOBAL_NAME_SPACE] = Utils;
  3611. })();

欢迎访问Greasy Fork镜像

土豆服务器，请按需使用

镜像地址随时可能被墙，建议加群获取最新地址

加入Q群

QingJ © 2025

镜像随时可能失效，请加Q群300939539或关注我们的公众号极客氢云获取最新地址