@whitesev/utils 2.11.8 → 2.11.10

package/dist/index.amd.js

@@ -239,7 +239,7 @@ define((function () { 'use strict';
     const setInterval$1 = (...args) => loadOrReturnBroker().setInterval(...args);
     const setTimeout$1 = (...args) => loadOrReturnBroker().setTimeout(...args);
 
-    const version = "2.11.8";
+    const version = "2.11.10";
 
     /* eslint-disable */
     // ==UserScript==
@@ -6208,6 +6208,10 @@ define((function () { 'use strict';
             if (typeof deviation !== "number" || Number.isNaN(deviation)) {
                 deviation = 10;
             }
+            // 最大值 2147483647
+            // const maxZIndex = Math.pow(2, 31) - 1;
+            // 比较值 2000000000
+            const maxZIndexCompare = 2 * Math.pow(10, 9);
             /** 坐标偏移 */
             const positionDistance = 10;
             const defaultCalcPostion = [];
@@ -6302,9 +6306,14 @@ define((function () { 'use strict';
                         left: maxRect.left,
                     };
                 }
+                let calcZIndex = zIndex + deviation;
+                if (calcZIndex >= maxZIndexCompare) {
+                    // 不要超过最大值
+                    calcZIndex = maxZIndexCompare;
+                }
                 return {
                     /** 计算偏移量后的z-index值 */
-                    zIndex: zIndex + deviation,
+                    zIndex: calcZIndex,
                     /** 获取到的最大的z-index值 */
                     originZIndex: zIndex,
                     /** 拥有最大z-index的元素 */
@@ -8341,6 +8350,20 @@ define((function () { 'use strict';
          * 深度获取对象的某个属性
          * @param target 待获取的对象
          * @param handler 获取属性的回调
+         * @example
+         * Utils.queryProperty(window,(target)=>{
+         *   if(target.xxx){
+         *     return {
+         *       isFind: true,
+         *       data: target.xxx,
+         *     }
+         *   }else{
+         *     return {
+         *       isFind: false,
+         *       data: target.aabbcc,
+         *     }
+         *   }
+         * })
          */
         queryProperty(target, handler) {
             if (target == null) {
@@ -8356,10 +8379,23 @@ define((function () { 'use strict';
          * 异步-深度获取对象属性
          * @param target 待获取的对象
          * @param handler 获取属性的回调
+         * @example
+         * Utils.asyncQueryProperty(window, async (target)=>{
+         *   if(target.xxx){
+         *     return {
+         *       isFind: true,
+         *       data: target.xxx,
+         *     }
+         *   }else{
+         *     return {
+         *       isFind: false,
+         *       data: target.aabbcc,
+         *     }
+         *   }
+         * })
          */
         async asyncQueryProperty(target, handler) {
             if (target == null) {
-                // @ts-expect-error 空返回
                 return;
             }
             const handleResult = await handler(target);
@@ -8371,7 +8407,8 @@ define((function () { 'use strict';
         /**
          * 创建一个新的Utils实例
          * @param option
-         * @returns
+         * @example
+         * Utils.createUtils();
          */
         createUtils(option) {
             return new Utils(option);
@@ -8439,7 +8476,9 @@ define((function () { 'use strict';
         /**
          * 覆盖对象中的函数this指向
          * @param target 需要覆盖的对象
-         * @param [objectThis] 覆盖的this指向，如果为传入，则默认为对象本身
+         * @param objectThis 覆盖的this指向，如果为传入，则默认为对象本身
+         * @example
+         * Utils.coverObjectFunctionThis({})
          */
         coverObjectFunctionThis = commonUtil.coverObjectFunctionThis.bind(commonUtil);
         /**
@@ -8490,7 +8529,7 @@ define((function () { 'use strict';
         /**
          * 自动使用 Worker 执行 setTimeout
          * @param callback 回调函数
-         * @param [timeout=0] 延迟时间，默认为0
+         * @param timeout 延迟时间，默认为0
          */
         workerSetTimeout(callback, timeout = 0) {
             try {
@@ -8561,6 +8600,10 @@ define((function () { 'use strict';
         /**
          * 判断页面中是否存在`worker-src`的CSP规则
          * @param timeout 超时时间，默认为`1500ms`
+         * @example
+         * Utils.hasWorkerCSP().then((hasCSP) => {
+         *   console.log(hasCSP);
+         * })
          */
         hasWorkerCSP(timeout = 1500) {
             return new Promise((resolve) => {