@whitesev/utils 2.11.8 → 2.11.9

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.9";
 
             /* eslint-disable */
             // ==UserScript==
@@ -8344,6 +8344,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 +8373,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 +8401,8 @@ System.register('Utils', [], (function (exports) {
                 /**
                  * 创建一个新的Utils实例
                  * @param option
-                 * @returns
+                 * @example
+                 * Utils.createUtils();
                  */
                 createUtils(option) {
                     return new Utils(option);
@@ -8442,7 +8470,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 +8523,7 @@ System.register('Utils', [], (function (exports) {
                 /**
                  * 自动使用 Worker 执行 setTimeout
                  * @param callback 回调函数
-                 * @param [timeout=0] 延迟时间，默认为0
+                 * @param timeout 延迟时间，默认为0
                  */
                 workerSetTimeout(callback, timeout = 0) {
                     try {
@@ -8564,6 +8594,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) => {