@skrillex1224/playwright-toolkit 2.1.239 → 2.1.241

package/dist/index.cjs

@@ -83,7 +83,7 @@ var createActorInfo = (info) => {
   const normalizeShare2 = (value) => {
     const raw = value && typeof value === "object" ? value : {};
     const modeRaw = String(raw.mode || "dom").trim().toLowerCase();
-    const mode = modeRaw === "response" ? "response" : "dom";
+    const mode = ["dom", "response", "custom"].includes(modeRaw) ? modeRaw : "dom";
     const prefix = String(raw.prefix || "").trim();
     const rawXurl = Array.isArray(raw.xurl) ? raw.xurl : [];
     const normalizeMatcherList = (input) => {
@@ -241,7 +241,7 @@ var ActorInfo = {
     path: "/",
     device: Device.Mobile,
     share: {
-      mode: "dom",
+      mode: "custom",
       prefix: "",
       xurl: []
     }
@@ -750,14 +750,16 @@ var expandScrollableContent = async (page, options = {}) => {
     expandDocumentElements: options.expandDocumentElements === true
   });
 };
-var pinBottomAffixedElements = async (page, options = {}) => {
+var adjustAffixedElementsForExpandedScreenshot = async (page, options = {}) => {
   return await page.evaluate(({ className, targetHeight }) => {
+    const viewportWidth = window.innerWidth || document.documentElement?.clientWidth || document.body?.clientWidth || 0;
     const viewportHeight = window.innerHeight || document.documentElement?.clientHeight || document.body?.clientHeight || 0;
+    const scrollY = window.scrollY || window.pageYOffset || 0;
     const safeTargetHeight = Math.ceil(Number(targetHeight) || 0);
-    const deltaY = safeTargetHeight - viewportHeight;
-    if (deltaY <= 1) {
+    if (safeTargetHeight <= viewportHeight + 1) {
       return 0;
     }
+    const hasOwn = (source, key) => Object.prototype.hasOwnProperty.call(source, key);
     const isVisible = (el, style, rect) => {
       if (!el || !style || !rect) return false;
       if (style.display === "none" || style.visibility === "hidden" || style.visibility === "collapse") {
@@ -766,7 +768,7 @@ var pinBottomAffixedElements = async (page, options = {}) => {
       if (Number(style.opacity) === 0) return false;
       return rect.width > 0 && rect.height > 0;
     };
-    const bottomThreshold = Math.max(24, Math.min(96, viewportHeight * 0.12));
+    const edgeThreshold = Math.max(24, Math.min(96, viewportHeight * 0.12));
     const maxAffixedHeight = Math.max(56, viewportHeight * 0.65);
     const candidates = [];
     document.querySelectorAll("*").forEach((el) => {
@@ -776,28 +778,49 @@ var pinBottomAffixedElements = async (page, options = {}) => {
       const rect = el.getBoundingClientRect();
       if (!isVisible(el, style, rect)) return;
       if (rect.height > maxAffixedHeight) return;
-      if (rect.bottom < viewportHeight - bottomThreshold) return;
+      if (rect.width < viewportWidth * 0.25 && rect.height < 80) return;
+      const top = Number.parseFloat(style.top);
       const bottom = Number.parseFloat(style.bottom);
+      const hasTopRule = Number.isFinite(top) && top <= Math.max(160, viewportHeight * 0.25);
       const hasBottomRule = Number.isFinite(bottom) && bottom <= Math.max(160, viewportHeight * 0.25);
-      const isNearViewportBottom = rect.bottom >= viewportHeight - bottomThreshold;
-      if (!hasBottomRule && !isNearViewportBottom) return;
-      candidates.push(el);
+      const isNearViewportTop = rect.top <= edgeThreshold;
+      const isNearViewportBottom = rect.bottom >= viewportHeight - edgeThreshold;
+      const edge = (hasBottomRule || isNearViewportBottom) && !(hasTopRule || isNearViewportTop) ? "bottom" : "top";
+      if (position === "fixed" && edge === "top" && !hasTopRule && !isNearViewportTop) return;
+      if (position === "fixed" && edge === "bottom" && !hasBottomRule && !isNearViewportBottom) return;
+      if (position === "sticky" && !hasTopRule && !hasBottomRule && !isNearViewportTop && !isNearViewportBottom) return;
+      candidates.push({ el, position, edge });
     });
-    const candidateSet = new Set(candidates);
-    const topLevelCandidates = candidates.filter((el) => {
+    const candidateSet = new Set(candidates.map(({ el }) => el));
+    const topLevelCandidates = candidates.filter(({ el }) => {
       for (let parent = el.parentElement; parent; parent = parent.parentElement) {
         if (candidateSet.has(parent)) return false;
       }
       return true;
     });
-    topLevelCandidates.forEach((el) => {
-      if (!Object.prototype.hasOwnProperty.call(el.dataset, "pkBottomPinned")) {
-        el.dataset.pkBottomPinned = "1";
+    topLevelCandidates.forEach(({ el, position, edge }) => {
+      if (!hasOwn(el.dataset, "pkAffixedAdjusted")) {
+        el.dataset.pkAffixedAdjusted = "1";
+        el.dataset.pkOrigPosition = el.style.getPropertyValue("position") || "";
+        el.dataset.pkOrigPositionPriority = el.style.getPropertyPriority("position") || "";
+        el.dataset.pkOrigTop = el.style.getPropertyValue("top") || "";
+        el.dataset.pkOrigTopPriority = el.style.getPropertyPriority("top") || "";
+        el.dataset.pkOrigBottom = el.style.getPropertyValue("bottom") || "";
+        el.dataset.pkOrigBottomPriority = el.style.getPropertyPriority("bottom") || "";
         el.dataset.pkOrigTranslate = el.style.getPropertyValue("translate") || "";
         el.dataset.pkOrigTranslatePriority = el.style.getPropertyPriority("translate") || "";
       }
       el.classList.add(className);
-      el.style.setProperty("translate", `0 ${Math.round(deltaY)}px`, "important");
+      if (position === "fixed") {
+        const deltaY = edge === "bottom" ? safeTargetHeight - viewportHeight - scrollY : -scrollY;
+        if (Math.abs(deltaY) > 1) {
+          el.style.setProperty("translate", `0 ${Math.round(deltaY)}px`, "important");
+        }
+        return;
+      }
+      el.style.setProperty("position", "relative", "important");
+      el.style.setProperty("top", "auto", "important");
+      el.style.setProperty("bottom", "auto", "important");
     });
     return topLevelCandidates.length;
   }, {
@@ -805,7 +828,7 @@ var pinBottomAffixedElements = async (page, options = {}) => {
     targetHeight: options.targetHeight
   });
 };
-var restoreBottomAffixedElements = async (page) => {
+var restoreAffixedElementsForExpandedScreenshot = async (page) => {
   await page.evaluate((className) => {
     const hasOwn = (source, key) => Object.prototype.hasOwnProperty.call(source, key);
     const expansionKeys = [
@@ -814,13 +837,28 @@ var restoreBottomAffixedElements = async (page) => {
       "pkOrigMinHeight",
       "pkOrigMaxHeight"
     ];
-    document.querySelectorAll('[data-pk-bottom-pinned="1"]').forEach((el) => {
+    document.querySelectorAll('[data-pk-affixed-adjusted="1"]').forEach((el) => {
+      if (hasOwn(el.dataset, "pkOrigPosition")) {
+        el.style.setProperty("position", el.dataset.pkOrigPosition || "", el.dataset.pkOrigPositionPriority || "");
+        delete el.dataset.pkOrigPosition;
+        delete el.dataset.pkOrigPositionPriority;
+      }
+      if (hasOwn(el.dataset, "pkOrigTop")) {
+        el.style.setProperty("top", el.dataset.pkOrigTop || "", el.dataset.pkOrigTopPriority || "");
+        delete el.dataset.pkOrigTop;
+        delete el.dataset.pkOrigTopPriority;
+      }
+      if (hasOwn(el.dataset, "pkOrigBottom")) {
+        el.style.setProperty("bottom", el.dataset.pkOrigBottom || "", el.dataset.pkOrigBottomPriority || "");
+        delete el.dataset.pkOrigBottom;
+        delete el.dataset.pkOrigBottomPriority;
+      }
       if (hasOwn(el.dataset, "pkOrigTranslate")) {
         el.style.setProperty("translate", el.dataset.pkOrigTranslate || "", el.dataset.pkOrigTranslatePriority || "");
         delete el.dataset.pkOrigTranslate;
         delete el.dataset.pkOrigTranslatePriority;
       }
-      delete el.dataset.pkBottomPinned;
+      delete el.dataset.pkAffixedAdjusted;
       const stillExpanded = expansionKeys.some((key) => hasOwn(el.dataset, key));
       if (!stillExpanded) {
         el.classList.remove(className);
@@ -849,8 +887,8 @@ var prepareExpandedFullPageScreenshot = async (page, options = {}) => {
     });
     viewportResized = true;
   } else {
-    await pinBottomAffixedElements(page, { targetHeight }).catch((error) => {
-      logger.warning(`\u79FB\u52A8\u7AEF\u5438\u5E95\u5143\u7D20\u91CD\u5B9A\u4F4D\u5931\u8D25: ${error?.message || error}`);
+    await adjustAffixedElementsForExpandedScreenshot(page, { targetHeight }).catch((error) => {
+      logger.warning(`\u79FB\u52A8\u7AEF\u5438\u9644\u5143\u7D20\u91CD\u5B9A\u4F4D\u5931\u8D25: ${error?.message || error}`);
     });
   }
   if (settleMs > 0) {
@@ -956,8 +994,8 @@ var captureExpandedFullPageScreenshot = async (page, options = {}) => {
       maxClipHeight: state.targetHeight
     });
   } finally {
-    await restoreBottomAffixedElements(page).catch((error) => {
-      logger.warning(`\u79FB\u52A8\u7AEF\u5438\u5E95\u5143\u7D20\u6062\u590D\u5931\u8D25: ${error?.message || error}`);
+    await restoreAffixedElementsForExpandedScreenshot(page).catch((error) => {
+      logger.warning(`\u79FB\u52A8\u7AEF\u5438\u9644\u5143\u7D20\u6062\u590D\u5931\u8D25: ${error?.message || error}`);
     });
     if (options.restore) {
       await restoreExpandedFullPageScreenshot(page, state);
@@ -3398,6 +3436,26 @@ var waitJitter = (base, jitterPercent = 0.3) => (0, import_delay3.default)(jitte
 // src/internals/humanize/mobile.js
 var logger7 = createInternalLogger("Humanize.Mobile");
 var initializedPages = /* @__PURE__ */ new WeakSet();
+var DEFAULT_TAP_TIMEOUT_MS = 2500;
+var DEFAULT_MOUSE_TAP_FALLBACK_TIMEOUT_MS = 1200;
+var DEFAULT_ACTIVATE_FALLBACK_TIMEOUT_MS = 900;
+var INTERACTIVE_SELECTOR = [
+  "button",
+  '[role="button"]',
+  "a[href]",
+  "label",
+  "input",
+  "textarea",
+  "select",
+  "summary",
+  '[contenteditable="true"]',
+  '[tabindex]:not([tabindex="-1"])'
+].join(",");
+var EDITABLE_SELECTOR = [
+  "input",
+  "textarea",
+  '[contenteditable="true"]'
+].join(",");
 var clamp = (value, min, max) => Math.min(max, Math.max(min, value));
 var resolveViewport = (page) => page?.viewportSize?.() || { width: 390, height: 844 };
 var describeTarget = (target) => {
@@ -3420,8 +3478,24 @@ var clipBoxToViewport = (box, viewport) => {
   }
   return box;
 };
+var withTimeout = async (operation, timeoutMs, label) => {
+  const safeTimeoutMs = Math.max(50, Number(timeoutMs || 0));
+  let timeoutId = null;
+  try {
+    return await Promise.race([
+      Promise.resolve().then(operation),
+      new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+          reject(new Error(`${label} timeout after ${safeTimeoutMs}ms`));
+        }, safeTimeoutMs);
+      })
+    ]);
+  } finally {
+    if (timeoutId) clearTimeout(timeoutId);
+  }
+};
 var checkElementVisibility = async (element) => {
-  return element.evaluate((el) => {
+  return element.evaluate((el, interactiveSelector) => {
     const targetStyle = window.getComputedStyle(el);
     if (!targetStyle || targetStyle.display === "none" || targetStyle.visibility === "hidden" || targetStyle.visibility === "collapse") {
       return { code: "NOT_INTERACTABLE", reason: "\u5143\u7D20\u4E0D\u53EF\u89C1", direction: "down" };
@@ -3438,10 +3512,12 @@ var checkElementVisibility = async (element) => {
     let clipTop = 0;
     let clipBottom = viewH;
     let isFixed = false;
+    let positioning = null;
     for (let node = el; node && node !== document.body; node = node.parentElement) {
       const style = window.getComputedStyle(node);
       if (style && (style.position === "fixed" || style.position === "sticky")) {
         isFixed = true;
+        positioning = style.position;
         break;
       }
     }
@@ -3477,21 +3553,10 @@ var checkElementVisibility = async (element) => {
         direction: centerY < clipTop ? "up" : "down",
         cy: centerY,
         viewH,
-        isFixed
+        isFixed,
+        positioning
       };
     }
-    const interactiveSelector = [
-      "button",
-      '[role="button"]',
-      "a[href]",
-      "label",
-      "input",
-      "textarea",
-      "select",
-      "summary",
-      '[contenteditable="true"]',
-      '[tabindex]:not([tabindex="-1"])'
-    ].join(",");
     const targetInteractive = typeof el.closest === "function" ? el.closest(interactiveSelector) : null;
     const sameInteractiveTarget = (pointElement) => {
       if (!pointElement) return false;
@@ -3513,6 +3578,7 @@ var checkElementVisibility = async (element) => {
         id: node.id || "",
         className,
         isFixed: Boolean(style && (style.position === "fixed" || style.position === "sticky")),
+        positioning: style?.position || "",
         top: rect2 ? rect2.top : null,
         bottom: rect2 ? rect2.bottom : null,
         left: rect2 ? rect2.left : null,
@@ -3530,7 +3596,7 @@ var checkElementVisibility = async (element) => {
     for (const point of samplePoints) {
       const pointElement = document.elementFromPoint(point.x, point.y);
       if (sameInteractiveTarget(pointElement)) {
-        return { code: "VISIBLE", isFixed };
+        return { code: "VISIBLE", isFixed, positioning };
       }
       obstruction = obstruction || describeElement(pointElement);
     }
@@ -3542,14 +3608,15 @@ var checkElementVisibility = async (element) => {
         obstruction,
         cy,
         viewH,
-        isFixed
+        isFixed,
+        positioning
       };
     }
-    return { code: "VISIBLE", isFixed };
-  });
+    return { code: "VISIBLE", isFixed, positioning };
+  }, INTERACTIVE_SELECTOR);
 };
 var resolveSafeTapPoint = async (element) => {
-  return element.evaluate((el) => {
+  return element.evaluate((el, interactiveSelector) => {
     const rect = el.getBoundingClientRect();
     if (!rect || rect.width <= 0 || rect.height <= 0) {
       return null;
@@ -3586,18 +3653,6 @@ var resolveSafeTapPoint = async (element) => {
     if (visibleWidth <= 1 || visibleHeight <= 1) {
       return null;
     }
-    const interactiveSelector = [
-      "button",
-      '[role="button"]',
-      "a[href]",
-      "label",
-      "input",
-      "textarea",
-      "select",
-      "summary",
-      '[contenteditable="true"]',
-      '[tabindex]:not([tabindex="-1"])'
-    ].join(",");
     const targetInteractive = typeof el.closest === "function" ? el.closest(interactiveSelector) : null;
     const sameInteractiveTarget = (pointElement) => {
       if (!pointElement) return false;
@@ -3635,6 +3690,46 @@ var resolveSafeTapPoint = async (element) => {
       x: chosen.x,
       y: chosen.y
     };
+  }, INTERACTIVE_SELECTOR);
+};
+var activateElementFallback = async (element, point = null, options = {}) => {
+  return element.evaluate((el, { innerPoint, innerOptions, interactiveSelector, editableSelector }) => {
+    const pointElement = innerPoint ? document.elementFromPoint(innerPoint.x, innerPoint.y) : null;
+    const nearestInteractive = (node) => {
+      if (!node || typeof node.closest !== "function") return null;
+      return node.closest(interactiveSelector);
+    };
+    const targetInteractive = nearestInteractive(el);
+    const pointInteractive = nearestInteractive(pointElement);
+    let target = null;
+    if (pointInteractive && (pointInteractive === targetInteractive || pointInteractive === el || pointInteractive.contains(el) || el.contains(pointInteractive))) {
+      target = pointInteractive;
+    }
+    target = target || targetInteractive || el;
+    const editable = typeof target.closest === "function" ? target.closest(editableSelector) : null;
+    if (editable && typeof editable.focus === "function") {
+      editable.focus({ preventScroll: true });
+      if (innerOptions.editableOnly) {
+        return { activated: true, method: "focus", tag: editable.tagName || "" };
+      }
+    }
+    if (typeof target.focus === "function") {
+      target.focus({ preventScroll: true });
+    }
+    if (!innerOptions.editableOnly && typeof target.click === "function") {
+      target.click();
+      return { activated: true, method: "dom-click", tag: target.tagName || "" };
+    }
+    return {
+      activated: Boolean(editable),
+      method: editable ? "focus" : "none",
+      tag: target?.tagName || ""
+    };
+  }, {
+    innerPoint: point,
+    innerOptions: options || {},
+    interactiveSelector: INTERACTIVE_SELECTOR,
+    editableSelector: EDITABLE_SELECTOR
   });
 };
 var getScrollableRect = async (element) => {
@@ -3839,12 +3934,31 @@ var dispatchTouchSwipe = async (page, deltaY, options = {}) => {
     }
   }
 };
-var tapPoint = async (page, point) => {
+var tapPoint = async (page, point, options = {}) => {
+  const {
+    timeoutMs = DEFAULT_TAP_TIMEOUT_MS,
+    mouseFallbackTimeoutMs = DEFAULT_MOUSE_TAP_FALLBACK_TIMEOUT_MS,
+    allowMouseFallback = true
+  } = options;
   if (page.touchscreen && typeof page.touchscreen.tap === "function") {
-    await page.touchscreen.tap(point.x, point.y);
-    return;
+    try {
+      await withTimeout(
+        () => page.touchscreen.tap(point.x, point.y),
+        timeoutMs,
+        "touchscreen.tap"
+      );
+      return { method: "touchscreen" };
+    } catch (error) {
+      logger7.warn(`tapPoint | touchscreen.tap \u5931\u8D25\u6216\u8D85\u65F6\uFF0C\u5C1D\u8BD5\u9F20\u6807\u515C\u5E95: ${error?.message || error}`);
+      if (!allowMouseFallback) throw error;
+    }
   }
-  await page.mouse.click(point.x, point.y);
+  await withTimeout(
+    () => page.mouse.click(point.x, point.y),
+    mouseFallbackTimeoutMs,
+    "mouse.click fallback"
+  );
+  return { method: "mouse" };
 };
 var MobileHumanize = {
   jitterMs,
@@ -3897,6 +4011,10 @@ var MobileHumanize = {
         return { element, didScroll, restore: null };
       }
       const scrollRect = await getScrollableRect(element);
+      if (!scrollRect && status.isFixed && status.code === "OUT_OF_VIEWPORT") {
+        logger7.warn(`humanScroll | fixed/sticky \u76EE\u6807\u4E0D\u5728\u89C6\u53E3\u5185\uFF0C\u9875\u9762\u6EDA\u52A8\u65E0\u6CD5\u6539\u53D8\u5176\u4F4D\u7F6E (direction=${status.direction || "unknown"})`);
+        return { element, didScroll, restore: null };
+      }
       if (!scrollRect && status.isFixed && status.code === "OBSTRUCTED") {
         logger7.warn(`humanScroll | fixed/sticky \u76EE\u6807\u88AB\u906E\u6321\uFF0C\u6EDA\u52A8\u65E0\u6CD5\u89E3\u9664 (${status.obstruction?.tag || "unknown"})`);
         return { element, didScroll, restore: null };
@@ -4017,7 +4135,12 @@ var MobileHumanize = {
     const {
       reactionDelay = 220,
       throwOnMissing = true,
-      scrollIfNeeded = true
+      scrollIfNeeded = true,
+      tapTimeoutMs = DEFAULT_TAP_TIMEOUT_MS,
+      mouseFallbackTimeoutMs = DEFAULT_MOUSE_TAP_FALLBACK_TIMEOUT_MS,
+      activateFallbackTimeoutMs = DEFAULT_ACTIVATE_FALLBACK_TIMEOUT_MS,
+      fallbackDomClick = true,
+      fallbackDomClickOnTapError = true
     } = options;
     const targetDesc = describeTarget(target);
     logger7.start("humanClick", `target=${targetDesc}`);
@@ -4028,6 +4151,9 @@ var MobileHumanize = {
         await tapPoint(page, {
           x: viewport.width * (0.45 + Math.random() * 0.1),
           y: viewport.height * (0.48 + Math.random() * 0.12)
+        }, {
+          timeoutMs: tapTimeoutMs,
+          mouseFallbackTimeoutMs
         });
         logger7.success("humanClick", "Tapped current position");
         return true;
@@ -4042,6 +4168,19 @@ var MobileHumanize = {
       }
       const status = await checkElementVisibility(element).catch(() => null);
       if (status && status.code !== "VISIBLE") {
+        if (fallbackDomClick && status.isFixed && status.code === "OUT_OF_VIEWPORT") {
+          const fallback = await withTimeout(
+            () => activateElementFallback(element, null, {
+              editableOnly: true
+            }),
+            activateFallbackTimeoutMs,
+            "focus fallback"
+          ).catch(() => null);
+          if (fallback?.activated) {
+            logger7.warn(`humanClick: fixed/sticky \u76EE\u6807\u4E0D\u5728\u89C6\u53E3\u5185\uFF0C\u5DF2\u7528 ${fallback.method} \u6FC0\u6D3B`);
+            return true;
+          }
+        }
         const message = `\u5143\u7D20\u4E0D\u53EF\u70B9\u51FB: ${status.reason || status.code}`;
         if (throwOnMissing) throw new Error(message);
         logger7.warn(`humanClick: ${message}\uFF0C\u8DF3\u8FC7\u70B9\u51FB`);
@@ -4056,7 +4195,23 @@ var MobileHumanize = {
       await waitJitter(reactionDelay, 0.45);
       const safePoint = await resolveSafeTapPoint(element).catch(() => null);
       const tapTarget = safePoint || randomPointInBox(clipBoxToViewport(box, resolveViewport(page)), 0.2);
-      await tapPoint(page, tapTarget);
+      try {
+        await tapPoint(page, tapTarget, {
+          timeoutMs: tapTimeoutMs,
+          mouseFallbackTimeoutMs
+        });
+      } catch (tapError) {
+        if (!fallbackDomClickOnTapError) throw tapError;
+        const fallback = await withTimeout(
+          () => activateElementFallback(element, tapTarget, {
+            editableOnly: false
+          }),
+          activateFallbackTimeoutMs,
+          "activation fallback"
+        ).catch(() => null);
+        if (!fallback?.activated) throw tapError;
+        logger7.warn(`humanClick: tap \u5931\u8D25\u540E\u5DF2\u7528 ${fallback.method} \u515C\u5E95: ${tapError?.message || tapError}`);
+      }
       await waitJitter(120, 0.35);
       logger7.success("humanClick");
       return true;
@@ -6874,7 +7029,7 @@ var getHostname = (url) => {
     return "\u672C\u5730\u9875\u9762";
   }
 };
-var withTimeout = async (promise, timeoutMs) => {
+var withTimeout2 = async (promise, timeoutMs) => {
   const safeTimeoutMs = Math.max(0, Number(timeoutMs) || 0);
   if (!safeTimeoutMs) {
     return promise;
@@ -6959,7 +7114,7 @@ var resolveWithCustomResolver = async (page, baseMeta, options = {}) => {
   const serverAddr = response && typeof response.serverAddr === "function" ? await response.serverAddr().catch(() => null) : null;
   const controller = typeof AbortController === "function" ? new AbortController() : null;
   try {
-    const resolved = await withTimeout(
+    const resolved = await withTimeout2(
       Promise.resolve(resolver({
         page,
         response,
@@ -7259,13 +7414,13 @@ var resolveWithIpLookup = async (page, options = {}) => {
     const contentType = normalizeText(await pickHeaderValue(response, ["content-type"]));
     let rawText = "";
     if (response && typeof response.text === "function") {
-      rawText = String(await withTimeout(
+      rawText = String(await withTimeout2(
         response.text().catch(() => ""),
         timeoutMs
       ) || "");
     }
     if (!rawText) {
-      rawText = String(await withTimeout(
+      rawText = String(await withTimeout2(
         probePage.evaluate(() => {
           return document.body?.innerText || document.documentElement?.innerText || "";
         }).catch(() => ""),
@@ -8368,7 +8523,7 @@ var normalizeXurl = (value) => {
 var normalizeShare = (share) => {
   const source = share && typeof share === "object" ? share : {};
   const modeRaw = String(source.mode || "dom").trim().toLowerCase();
-  const mode = modeRaw === "response" ? "response" : "dom";
+  const mode = ["dom", "response", "custom"].includes(modeRaw) ? modeRaw : "dom";
   return {
     mode,
     prefix: normalizePrefix(source.prefix),
@@ -8484,16 +8639,17 @@ var Share = {
    * 捕获分享链接（单模式）
    * - mode='dom': 仅 DOM 监听
    * - mode='response': 仅接口监听
+   * - mode='custom': 使用 performActions 返回值作为链接
    *
    * @param {import('playwright').Page} page
    * @param {Object} [options]
-   * @param {{ mode?: 'dom' | 'response', prefix: string, xurl?: Array<string | string[]> }} options.share
+   * @param {{ mode?: 'dom' | 'response' | 'custom', prefix: string, xurl?: Array<string | string[]> }} options.share
    * @param {number} [options.timeoutMs=50000]
    * @param {number} [options.payloadSnapshotMaxLen=500]
    * @param {string | string[]} [options.domSelectors='html']
    * @param {'added' | 'changed' | 'all'} [options.domMode='all']
-   * @param {() => Promise<void>} [options.performActions]
-   * @returns {Promise<{ link: string | null; payloadText: string; payloadSnapshot: string; source: 'dom' | 'response' | 'none' }>}
+   * @param {() => void | string | { link?: string | null; payloadText?: string } | Promise<void | string | { link?: string | null; payloadText?: string }>} [options.performActions]
+   * @returns {Promise<{ link: string | null; payloadText: string; payloadSnapshot: string; source: 'dom' | 'response' | 'custom' | 'none' }>}
    */
   async captureLink(page, options = {}) {
     const share = normalizeShare(options.share);
@@ -8506,7 +8662,7 @@ var Share = {
     if (share.prefix === void 0) {
       throw new Error("Share.captureLink requires options.share.prefix");
     }
-    if (share.mode !== "dom" && share.mode !== "response") {
+    if (share.mode !== "dom" && share.mode !== "response" && share.mode !== "custom") {
       throw new Error(`Share.captureLink unsupported share.mode: ${share.mode}`);
     }
     const apiMatchers = share.mode === "response" ? share.xurl[0] || [] : [];
@@ -8528,7 +8684,8 @@ var Share = {
     };
     const candidates = {
       dom: null,
-      response: null
+      response: null,
+      custom: null
     };
     const setCandidate = (source, link, payloadText = "") => {
       const safe = String(link || "").trim();
@@ -8628,37 +8785,47 @@ var Share = {
       logger15.info(`\u5F53\u524D\u4E3A\u63A5\u53E3\u6A21\u5F0F\uFF0C\u6302\u8F7D response \u76D1\u542C: apiMatchers=${toJsonInline(apiMatchers, 160)}`);
       page.on("response", onResponse);
     }
+    if (share.mode === "custom") {
+      logger15.info("\u5F53\u524D\u4E3A custom \u6A21\u5F0F\uFF0C\u5C06\u4F7F\u7528 performActions \u8FD4\u56DE\u503C");
+    }
     const deadline = Date.now() + timeoutMs;
     const getRemainingMs = () => Math.max(0, deadline - Date.now());
     try {
       const actionTimeout = getRemainingMs();
       logger15.start("captureLink.performActions", `\u6267\u884C\u52A8\u4F5C\u9884\u7B97=${actionTimeout}ms`);
+      let actionValue;
       if (actionTimeout > 0) {
         let timer = null;
-        let actionError = null;
-        const actionPromise = Promise.resolve().then(() => performActions()).then(() => "__ACTION_DONE__").catch((error) => {
-          actionError = error;
-          return "__ACTION_ERROR__";
-        });
+        const actionPromise = Promise.resolve().then(() => performActions()).then((result) => ({ type: "done", result })).catch((error) => ({ type: "error", error }));
         const timeoutPromise = new Promise((resolve) => {
-          timer = setTimeout(() => resolve("__ACTION_TIMEOUT__"), actionTimeout);
+          timer = setTimeout(() => resolve({ type: "timeout" }), actionTimeout);
         });
         const actionResult = await Promise.race([actionPromise, timeoutPromise]);
         if (timer) clearTimeout(timer);
-        if (actionResult === "__ACTION_ERROR__") {
-          logger15.fail("captureLink.performActions", actionError);
-          throw actionError;
+        if (actionResult.type === "error") {
+          logger15.fail("captureLink.performActions", actionResult.error);
+          throw actionResult.error;
         }
-        if (actionResult === "__ACTION_TIMEOUT__") {
+        if (actionResult.type === "timeout") {
           stats.actionTimedOut = true;
           logger15.warning(`performActions \u5DF2\u8D85\u65F6 (${actionTimeout}ms)\uFF0C\u52A8\u4F5C\u53EF\u80FD\u4ECD\u5728\u5F02\u6B65\u6267\u884C`);
         } else {
+          actionValue = actionResult.result;
           logger15.success("captureLink.performActions", "\u6267\u884C\u52A8\u4F5C\u5B8C\u6210");
         }
       }
+      if (share.mode === "custom") {
+        const customLink = typeof actionValue === "string" ? actionValue : actionValue?.link || actionValue?.payloadText;
+        const customPayloadText = typeof actionValue === "string" ? actionValue : actionValue?.payloadText;
+        if (setCandidate("custom", customLink, customPayloadText)) {
+          logger15.success("captureLink.customResult", `custom \u547D\u4E2D\u5206\u4EAB\u94FE\u63A5: link=${candidates.custom.link}`);
+        } else {
+          logger15.warning("performActions \u6267\u884C\u5B8C\u6210\u4F46\u672A\u8FD4\u56DE\u6709\u6548\u5206\u4EAB\u94FE\u63A5");
+        }
+      }
       let nextProgressLogTs = Date.now() + 3e3;
       while (true) {
-        const selected = share.mode === "dom" ? candidates.dom : candidates.response;
+        const selected = candidates[share.mode];
         if (selected?.link) {
           logger15.success("captureLink", `\u6355\u83B7\u6210\u529F: source=${share.mode}, link=${selected.link}`);
           return {
@@ -8668,6 +8835,7 @@ var Share = {
             source: share.mode
           };
         }
+        if (share.mode === "custom") break;
         const remaining = getRemainingMs();
         if (remaining <= 0) break;
         const now = Date.now();