@skrillex1224/playwright-toolkit 2.1.120 → 2.1.121

package/dist/index.cjs

@@ -260,18 +260,18 @@ var fallbackLog = {
   error: (...args) => console.error(...args),
   debug: (...args) => console.debug ? console.debug(...args) : console.log(...args)
 };
-var resolveLogMethod = (logger11, name) => {
-  if (logger11 && typeof logger11[name] === "function") {
-    return logger11[name].bind(logger11);
+var resolveLogMethod = (logger12, name) => {
+  if (logger12 && typeof logger12[name] === "function") {
+    return logger12[name].bind(logger12);
   }
-  if (name === "warning" && logger11 && typeof logger11.warn === "function") {
-    return logger11.warn.bind(logger11);
+  if (name === "warning" && logger12 && typeof logger12.warn === "function") {
+    return logger12.warn.bind(logger12);
   }
   return fallbackLog[name];
 };
 var defaultLogger = null;
-var setDefaultLogger = (logger11) => {
-  defaultLogger = logger11;
+var setDefaultLogger = (logger12) => {
+  defaultLogger = logger12;
 };
 var resolveLogger = (explicitLogger) => {
   if (explicitLogger && typeof explicitLogger.info === "function") {
@@ -298,8 +298,8 @@ var colorize = (text, color) => {
 var createBaseLogger = (prefix = "", explicitLogger) => {
   const name = prefix ? String(prefix) : "";
   const dispatch = (methodName, icon, message, color) => {
-    const logger11 = resolveLogger(explicitLogger);
-    const logFn = resolveLogMethod(logger11, methodName);
+    const logger12 = resolveLogger(explicitLogger);
+    const logFn = resolveLogMethod(logger12, methodName);
     const timestamp = colorize(`[${formatTimestamp()}]`, ANSI.gray);
     const line = formatLine(name, icon, message);
     const coloredLine = colorize(line, color);
@@ -3092,7 +3092,7 @@ var createTemplateLogger = (baseLogger = createBaseLogger()) => {
 };
 var getDefaultBaseLogger = () => createBaseLogger("");
 var Logger = {
-  setLogger: (logger11) => setDefaultLogger(logger11),
+  setLogger: (logger12) => setDefaultLogger(logger12),
   info: (message) => getDefaultBaseLogger().info(message),
   success: (message) => getDefaultBaseLogger().success(message),
   warning: (message) => getDefaultBaseLogger().warning(message),
@@ -3100,18 +3100,36 @@ var Logger = {
   error: (message) => getDefaultBaseLogger().error(message),
   debug: (message) => getDefaultBaseLogger().debug(message),
   start: (message) => getDefaultBaseLogger().start(message),
-  useTemplate: (logger11) => {
-    if (logger11) return createTemplateLogger(createBaseLogger("", logger11));
+  useTemplate: (logger12) => {
+    if (logger12) return createTemplateLogger(createBaseLogger("", logger12));
     return createTemplateLogger();
   }
 };
 
 // src/share.js
 var import_delay3 = __toESM(require("delay"), 1);
-var DEFAULT_TIMEOUT_MS = 30 * 1e3;
+var logger11 = createInternalLogger("Share");
+var DEFAULT_TIMEOUT_MS = 50 * 1e3;
 var DEFAULT_PAYLOAD_SNAPSHOT_MAX_LEN = 500;
 var DEFAULT_POLL_INTERVAL_MS = 120;
 var normalizePrefix = (value) => String(value || "").trim();
+var toSnapshot = (value, maxLen) => {
+  const text = String(value || "");
+  if (!text) return "";
+  return text.replace(/\s+/g, " ").trim().slice(0, maxLen);
+};
+var toInline = (value, maxLen = 200) => {
+  const text = String(value || "");
+  if (!text) return "";
+  return text.replace(/\s+/g, " ").trim().slice(0, maxLen);
+};
+var toJsonInline = (value, maxLen = 260) => {
+  try {
+    return toInline(JSON.stringify(value), maxLen);
+  } catch {
+    return "[\u4E0D\u53EF\u5E8F\u5217\u5316]";
+  }
+};
 var normalizeXurl = (value) => {
   if (!Array.isArray(value)) return [];
   const normalizeMatcherList = (input) => {
@@ -3167,11 +3185,6 @@ var normalizeShare = (share) => {
     xurl: normalizeXurl(source.xurl)
   };
 };
-var toSnapshot = (value, maxLen) => {
-  const text = String(value || "");
-  if (!text) return "";
-  return text.replace(/\s+/g, " ").trim().slice(0, maxLen);
-};
 var getByPathSegments = (source, pathSegments) => {
   if (!Array.isArray(pathSegments) || pathSegments.length === 0) return void 0;
   let current = source;
@@ -3213,33 +3226,49 @@ var createDomShareMonitor = async (page, options = {}) => {
   const selectors = options.selectors ?? "html";
   const mode = options.mode ?? Mutation.Mode.All;
   const onMatch = typeof options.onMatch === "function" ? options.onMatch : null;
+  const onTelemetry = typeof options.onTelemetry === "function" ? options.onTelemetry : null;
   let matched = false;
+  logger11.info(`DOM \u76D1\u542C\u51C6\u5907\u6302\u8F7D: selectors=${toJsonInline(selectors, 120)}, mode=${mode}`);
   const monitor = await Mutation.useMonitor(page, selectors, {
     mode,
     onMutation: (context = {}) => {
       if (matched) return;
+      const mutationCount = Number(context.mutationCount || 0);
+      const mutationNodes = Array.isArray(context.mutationNodes) ? context.mutationNodes : [];
       const html = String(context.html || "");
       const text = String(context.text || "");
       const rawDom = `${html}
 ${text}`;
+      if (onTelemetry) {
+        onTelemetry({
+          mutationCount,
+          mutationNodesCount: mutationNodes.length
+        });
+      }
+      if (mutationCount <= 5 || mutationCount % 50 === 0) {
+        logger11.info(`DOM \u53D8\u5316\u5DF2\u6355\u83B7: mutationCount=${mutationCount}, mutationNodes=${mutationNodes.length}`);
+      }
       const [candidate] = Utils.parseLinks(rawDom, { prefix }) || [];
       if (!candidate) return;
       matched = true;
+      logger11.success("captureLink.domHit", `DOM \u547D\u4E2D\u5206\u4EAB\u94FE\u63A5: mutationCount=${mutationCount}, link=${candidate}`);
       if (onMatch) {
         onMatch({
           link: candidate,
           rawDom,
-          mutationCount: context.mutationCount || 0,
+          mutationCount,
           html,
           text,
-          mutationNodes: Array.isArray(context.mutationNodes) ? context.mutationNodes : []
+          mutationNodes
         });
       }
     }
   });
   return {
     stop: async () => {
-      return await monitor.stop();
+      const result = await monitor.stop();
+      logger11.info(`DOM \u76D1\u542C\u5DF2\u505C\u6B62: totalMutations=${result?.totalMutations || 0}`);
+      return result;
     }
   };
 };
@@ -3252,7 +3281,7 @@ var Share = {
    * @param {import('playwright').Page} page
    * @param {Object} [options]
    * @param {{ mode?: 'dom' | 'response', prefix: string, xurl?: Array<string | string[]> }} options.share
-   * @param {number} [options.timeoutMs=30000]
+   * @param {number} [options.timeoutMs=50000]
    * @param {number} [options.payloadSnapshotMaxLen=500]
    * @param {string | string[]} [options.domSelectors='html']
    * @param {'added' | 'changed' | 'all'} [options.domMode='all']
@@ -3278,6 +3307,18 @@ var Share = {
     if (share.mode === "response" && apiMatchers.length === 0) {
       throw new Error("Share.captureLink requires share.xurl[0] api matcher when mode=response");
     }
+    logger11.start("captureLink", `mode=${share.mode}, timeoutMs=${timeoutMs}, prefix=${share.prefix}`);
+    logger11.info(`captureLink \u914D\u7F6E: xurl=${toJsonInline(share.xurl)}, domMode=${domMode}, domSelectors=${toJsonInline(domSelectors, 120)}`);
+    const stats = {
+      actionTimedOut: false,
+      domMutationCount: 0,
+      domMutationNodes: 0,
+      responseObserved: 0,
+      responseMatched: 0,
+      responseResolved: 0,
+      lastMatchedUrl: "",
+      responseSampleUrls: []
+    };
     const candidates = {
       dom: null,
       response: null
@@ -3292,6 +3333,7 @@ var Share = {
         link: validated,
         payloadText: String(payloadText || "")
       };
+      logger11.info(`\u5019\u9009\u94FE\u63A5\u5DF2\u786E\u8BA4: source=${source}, link=${validated}`);
       return true;
     };
     const resolveResponseCandidate = (responseText) => {
@@ -3325,39 +3367,65 @@ var Share = {
       domMonitor = null;
       try {
         await monitor.stop();
-      } catch {
+      } catch (error) {
+        logger11.warning(`\u505C\u6B62 DOM \u76D1\u542C\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`);
       }
     };
     const onResponse = async (response) => {
       if (share.mode !== "response") return;
       if (candidates.response?.link) return;
+      stats.responseObserved += 1;
       try {
         const url = String(response.url() || "");
+        if (url && stats.responseSampleUrls.length < 8 && !stats.responseSampleUrls.includes(url)) {
+          stats.responseSampleUrls.push(url);
+        }
+        if (stats.responseObserved <= 5) {
+          logger11.info(`\u63A5\u53E3\u54CD\u5E94\u91C7\u6837(${stats.responseObserved}): ${url}`);
+        }
         if (!apiMatchers.some((matcher) => url.includes(matcher))) return;
+        stats.responseMatched += 1;
+        stats.lastMatchedUrl = url;
+        logger11.info(`\u63A5\u53E3\u547D\u4E2D\u5339\u914D(${stats.responseMatched}): ${url}`);
         const text = await response.text();
         const hit = resolveResponseCandidate(text);
-        if (!hit?.link) return;
+        if (!hit?.link) {
+          if (stats.responseMatched <= 3) {
+            logger11.info(`\u63A5\u53E3\u89E3\u6790\u5B8C\u6210\u4F46\u672A\u63D0\u53D6\u5230\u5206\u4EAB\u94FE\u63A5: payloadSize=${text.length}`);
+          }
+          return;
+        }
+        stats.responseResolved += 1;
+        logger11.success("captureLink.responseHit", `\u63A5\u53E3\u547D\u4E2D\u5206\u4EAB\u94FE\u63A5: url=${url}, link=${hit.link}`);
         setCandidate("response", hit.link, hit.payloadText);
-      } catch {
+      } catch (error) {
+        logger11.warning(`\u63A5\u53E3\u54CD\u5E94\u5904\u7406\u5F02\u5E38: ${error instanceof Error ? error.message : String(error)}`);
       }
     };
     if (share.mode === "dom") {
+      logger11.info("\u5F53\u524D\u4E3A DOM \u6A21\u5F0F\uFF0C\u4EC5\u542F\u7528 DOM \u76D1\u542C");
       domMonitor = await createDomShareMonitor(page, {
         prefix: share.prefix,
         selectors: domSelectors,
         mode: domMode,
+        onTelemetry: ({ mutationCount, mutationNodesCount }) => {
+          stats.domMutationCount = mutationCount;
+          stats.domMutationNodes = mutationNodesCount;
+        },
         onMatch: ({ link, rawDom }) => {
           setCandidate("dom", link, rawDom);
         }
       });
     }
     if (share.mode === "response") {
+      logger11.info(`\u5F53\u524D\u4E3A\u63A5\u53E3\u6A21\u5F0F\uFF0C\u6302\u8F7D response \u76D1\u542C: apiMatchers=${toJsonInline(apiMatchers, 160)}`);
       page.on("response", onResponse);
     }
     const deadline = Date.now() + timeoutMs;
     const getRemainingMs = () => Math.max(0, deadline - Date.now());
     try {
       const actionTimeout = getRemainingMs();
+      logger11.start("captureLink.performActions", `\u6267\u884C\u52A8\u4F5C\u9884\u7B97=${actionTimeout}ms`);
       if (actionTimeout > 0) {
         let timer = null;
         let actionError = null;
@@ -3371,12 +3439,21 @@ var Share = {
         const actionResult = await Promise.race([actionPromise, timeoutPromise]);
         if (timer) clearTimeout(timer);
         if (actionResult === "__ACTION_ERROR__") {
+          logger11.fail("captureLink.performActions", actionError);
           throw actionError;
         }
+        if (actionResult === "__ACTION_TIMEOUT__") {
+          stats.actionTimedOut = true;
+          logger11.warning(`performActions \u5DF2\u8D85\u65F6 (${actionTimeout}ms)\uFF0C\u52A8\u4F5C\u53EF\u80FD\u4ECD\u5728\u5F02\u6B65\u6267\u884C`);
+        } else {
+          logger11.success("captureLink.performActions", "\u6267\u884C\u52A8\u4F5C\u5B8C\u6210");
+        }
       }
+      let nextProgressLogTs = Date.now() + 3e3;
       while (true) {
         const selected = share.mode === "dom" ? candidates.dom : candidates.response;
         if (selected?.link) {
+          logger11.success("captureLink", `\u6355\u83B7\u6210\u529F: source=${share.mode}, link=${selected.link}`);
           return {
             link: selected.link,
             payloadText: selected.payloadText,
@@ -3386,8 +3463,23 @@ var Share = {
         }
         const remaining = getRemainingMs();
         if (remaining <= 0) break;
+        const now = Date.now();
+        if (now >= nextProgressLogTs) {
+          logger11.info(
+            `captureLink \u7B49\u5F85\u4E2D: remaining=${remaining}ms, domMutationCount=${stats.domMutationCount}, responseMatched=${stats.responseMatched}`
+          );
+          nextProgressLogTs = now + 5e3;
+        }
         await (0, import_delay3.default)(Math.max(0, Math.min(DEFAULT_POLL_INTERVAL_MS, remaining)));
       }
+      if (share.mode === "response" && stats.responseMatched === 0) {
+        logger11.warning(
+          `\u63A5\u53E3\u76D1\u542C\u672A\u547D\u4E2D: apiMatchers=${toJsonInline(apiMatchers, 220)}, \u54CD\u5E94\u6837\u672CURLs=${toJsonInline(stats.responseSampleUrls, 420)}`
+        );
+      }
+      logger11.warning(
+        `captureLink \u8D85\u65F6\u672A\u62FF\u5230\u94FE\u63A5: mode=${share.mode}, actionTimedOut=${stats.actionTimedOut}, domMutationCount=${stats.domMutationCount}, responseObserved=${stats.responseObserved}, responseMatched=${stats.responseMatched}, lastMatchedUrl=${stats.lastMatchedUrl || "none"}`
+      );
       return {
         link: null,
         payloadText: "",
@@ -3397,6 +3489,7 @@ var Share = {
     } finally {
       if (share.mode === "response") {
         page.off("response", onResponse);
+        logger11.info("response \u76D1\u542C\u5DF2\u5378\u8F7D");
       }
       await stopDomMonitor();
     }