@whitesev/utils 2.11.8 → 2.11.10

package/dist/index.system.js

@@ -242,7 +242,7 @@ System.register('Utils', [], (function (exports) {
             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==
@@ -6211,6 +6211,10 @@ System.register('Utils', [], (function (exports) {
                     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 = [];
@@ -6305,9 +6309,14 @@ System.register('Utils', [], (function (exports) {
                                 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的元素 */
@@ -8344,6 +8353,20 @@ System.register('Utils', [], (function (exports) {
                  * 深度获取对象的某个属性
                  * @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) {
@@ -8359,10 +8382,23 @@ System.register('Utils', [], (function (exports) {
                  * 异步-深度获取对象属性
                  * @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);
@@ -8374,7 +8410,8 @@ System.register('Utils', [], (function (exports) {
                 /**
                  * 创建一个新的Utils实例
                  * @param option
-                 * @returns
+                 * @example
+                 * Utils.createUtils();
                  */
                 createUtils(option) {
                     return new Utils(option);
@@ -8442,7 +8479,9 @@ System.register('Utils', [], (function (exports) {
                 /**
                  * 覆盖对象中的函数this指向
                  * @param target 需要覆盖的对象
-                 * @param [objectThis] 覆盖的this指向，如果为传入，则默认为对象本身
+                 * @param objectThis 覆盖的this指向，如果为传入，则默认为对象本身
+                 * @example
+                 * Utils.coverObjectFunctionThis({})
                  */
                 coverObjectFunctionThis = commonUtil.coverObjectFunctionThis.bind(commonUtil);
                 /**
@@ -8493,7 +8532,7 @@ System.register('Utils', [], (function (exports) {
                 /**
                  * 自动使用 Worker 执行 setTimeout
                  * @param callback 回调函数
-                 * @param [timeout=0] 延迟时间，默认为0
+                 * @param timeout 延迟时间，默认为0
                  */
                 workerSetTimeout(callback, timeout = 0) {
                     try {
@@ -8564,6 +8603,10 @@ System.register('Utils', [], (function (exports) {
                 /**
                  * 判断页面中是否存在`worker-src`的CSP规则
                  * @param timeout 超时时间，默认为`1500ms`
+                 * @example
+                 * Utils.hasWorkerCSP().then((hasCSP) => {
+                 *   console.log(hasCSP);
+                 * })
                  */
                 hasWorkerCSP(timeout = 1500) {
                     return new Promise((resolve) => {