@skrillex1224/playwright-toolkit 2.1.56 → 2.1.58

package/dist/index.cjs

@@ -2328,8 +2328,9 @@ var Mutation = {
    * @param {import('playwright').Page} page - Playwright page 对象
    * @param {string | string[]} selectors - 要监控的 CSS 选择器，单个或多个
    * @param {Object} [options] - 配置选项
+   * @param {number} [options.initialTimeout] - 等待元素出现的超时 (毫秒, 默认: 30000)
    * @param {number} [options.stableTime] - 无变化持续时间后 resolve (毫秒, 默认: 5000)
-   * @param {number} [options.timeout] - 整体超时时间 (毫秒, 默认: 60000)
+   * @param {number} [options.timeout] - 整体超时时间 (毫秒, 默认: 120000)
    * @param {Function} [options.onMutation] - 变化时的回调钩子
    *   签名: ({ mutationCount, innerHTML, innerText }) => any
    *   返回 null/undefined: 正常重置稳定计时
@@ -2338,10 +2339,21 @@ var Mutation = {
    */
   async waitForStable(page, selectors, options = {}) {
     const selectorList = Array.isArray(selectors) ? selectors : [selectors];
-    const stableTime = options.stableTime ?? 5e3;
-    const timeout = options.timeout ?? 6e4;
+    const initialTimeout = options.initialTimeout ?? 30 * 1e3;
+    const stableTime = options.stableTime ?? 5 * 1e3;
+    const timeout = options.timeout ?? 120 * 1e3;
     const onMutation = options.onMutation;
     logger10.start("waitForStable", `\u76D1\u63A7 ${selectorList.length} \u4E2A\u9009\u62E9\u5668, \u7A33\u5B9A\u65F6\u95F4=${stableTime}ms`);
+    if (initialTimeout > 0) {
+      const selectorQuery = selectorList.join(",");
+      try {
+        await page.waitForSelector(selectorQuery, { timeout: initialTimeout });
+        logger10.info(`waitForStable \u5DF2\u68C0\u6D4B\u5230\u5143\u7D20: ${selectorQuery}`);
+      } catch (e) {
+        logger10.warning(`waitForStable \u521D\u59CB\u7B49\u5F85\u8D85\u65F6 (${initialTimeout}ms): ${selectorQuery}`);
+        throw e;
+      }
+    }
     const callbackName = generateKey("pk_mut_cb");
     if (onMutation) {
       try {
@@ -2409,9 +2421,14 @@ var Mutation = {
                       innerHTML,
                       innerText
                     });
-                    setPaused(signal === "__PAUSE__");
+                    const shouldPause = signal === "__PAUSE__";
+                    setPaused(shouldPause);
+                    if (!shouldPause) {
+                      resetStableTimer();
+                    }
                   } catch (e) {
                     setPaused(false);
+                    resetStableTimer();
                   }
                 } else {
                   resetStableTimer();
@@ -2445,7 +2462,7 @@ var Mutation = {
                     innerText
                   });
                   if (signal === "__PAUSE__") {
-                    pauseStableTimer();
+                    setPaused(true);
                     return;
                   }
                 } catch (e) {