@skrillex1224/playwright-toolkit 2.1.111 → 2.1.113

package/README.md

@@ -208,7 +208,7 @@ const cookies = Utils.parseCookies('key=value; key2=value2', '.example.com');
 await page.context().addCookies(cookies);
 
 // 全页面滚动截图 (自动检测所有滚动元素，强制展开后截图)
-const base64Image = await Utils.fullPageScreenshot(page);
+const base64Image = await Share.captureScreen(page);
 // 返回 base64 编码的 PNG 图片
 ```
 

package/dist/index.cjs

@@ -3025,36 +3025,121 @@ var Logger = {
 
 // src/share.js
 var import_delay3 = __toESM(require("delay"), 1);
+
+// src/internals/monitor.js
+var DEFAULT_DOM_SELECTORS = "html";
+var Monitor = {
+  /**
+   * 使用 Mutation.useMonitor 监控 DOM，并提取分享链接
+   *
+   * @param {import('playwright').Page} page
+   * @param {Object} [options]
+   * @param {string[]} [options.identities]
+   * @param {string | string[]} [options.selectors]
+   * @param {'added' | 'changed' | 'all'} [options.mode]
+   * @param {(text: string, options?: { identities?: string[] }) => string[]} [options.parseLinks]
+   * @param {(payload: { link: string; rawDom: string; mutationCount: number; html: string; text: string; mutationNodes: Array<{ html: string; text: string; mutationType: string }> }) => void} [options.onMatch]
+   * @returns {Promise<{ stop: () => Promise<{ totalMutations: number }> }>}
+   */
+  async useShareLinkMonitor(page, options = {}) {
+    const identities = Array.isArray(options.identities) ? options.identities : [];
+    const selectors = options.selectors ?? DEFAULT_DOM_SELECTORS;
+    const mode = options.mode ?? Mutation.Mode.Added;
+    const parseLinks = typeof options.parseLinks === "function" ? options.parseLinks : Utils.parseLinks;
+    const onMatch = typeof options.onMatch === "function" ? options.onMatch : null;
+    let matched = false;
+    const monitor = await Mutation.useMonitor(page, selectors, {
+      mode,
+      onMutation: (context = {}) => {
+        if (matched) return;
+        const html = String(context.html || "");
+        const text = String(context.text || "");
+        const rawDom = `${html}
+${text}`;
+        const [candidate] = parseLinks(rawDom, { identities }) || [];
+        if (!candidate) return;
+        matched = true;
+        if (onMatch) {
+          onMatch({
+            link: candidate,
+            rawDom,
+            mutationCount: context.mutationCount || 0,
+            html,
+            text,
+            mutationNodes: Array.isArray(context.mutationNodes) ? context.mutationNodes : []
+          });
+        }
+      }
+    });
+    return {
+      stop: async () => {
+        return await monitor.stop();
+      }
+    };
+  }
+};
+
+// src/share.js
 var DEFAULT_TIMEOUT_AFTER_ACTION_MS = 10 * 1e3;
 var DEFAULT_PAYLOAD_SNAPSHOT_MAX_LEN = 500;
 var Share = {
   /**
-   * 捕获分享链接（仅通过接口响应文本匹配，不依赖 DOM / 剪切板）
+   * 捕获分享链接（接口响应 + DOM 监听 双通道）
    *
    * @param {import('playwright').Page} page
    * @param {Object} [options]
    * @param {string[]} [options.identities]
    * @param {number} [options.timeoutAfterActionMs]
    * @param {number} [options.payloadSnapshotMaxLen]
+   * @param {boolean} [options.enableResponse=true]
+   * @param {boolean} [options.enableDom=true]
+   * @param {string | string[]} [options.domSelectors='html']
+   * @param {'added' | 'changed' | 'all'} [options.domMode='added']
    * @param {(response: import('playwright').Response) => boolean | Promise<boolean>} [options.responseFilter]
    * @param {(text: string, options?: { identities?: string[] }) => string[]} [options.parseLinks]
    * @param {() => Promise<void>} [options.performActions]
-   * @returns {Promise<{ link: string | null; payloadText: string; payloadSnapshot: string; source: 'response' | 'none' }>}
+   * @returns {Promise<{ link: string | null; payloadText: string; payloadSnapshot: string; source: 'response' | 'dom' | 'none' }>}
    */
   async captureLink(page, options = {}) {
     const identities = Array.isArray(options.identities) ? options.identities : [];
     const timeoutAfterActionMs = options.timeoutAfterActionMs ?? DEFAULT_TIMEOUT_AFTER_ACTION_MS;
     const payloadSnapshotMaxLen = options.payloadSnapshotMaxLen ?? DEFAULT_PAYLOAD_SNAPSHOT_MAX_LEN;
+    const enableResponse = options.enableResponse !== false;
+    const enableDom = options.enableDom !== false;
+    const domSelectors = options.domSelectors ?? "html";
+    const domMode = options.domMode ?? Mutation.Mode.All;
     const responseFilter = typeof options.responseFilter === "function" ? options.responseFilter : null;
     const parseLinks = typeof options.parseLinks === "function" ? options.parseLinks : Utils.parseLinks;
     const performActions = typeof options.performActions === "function" ? options.performActions : async () => {
     };
+    if (!enableResponse && !enableDom) {
+      throw new Error("Share.captureLink requires at least one channel: response or dom");
+    }
     let link = null;
     let payloadText = "";
+    let source = "none";
     let resolveMatched = null;
+    let domMonitor = null;
     const matchedPromise = new Promise((resolve) => {
       resolveMatched = resolve;
     });
+    const finalizeMatch = (candidate, matchedSource, payload) => {
+      if (link || !candidate) return false;
+      link = candidate;
+      source = matchedSource;
+      payloadText = String(payload || "");
+      if (resolveMatched) resolveMatched(candidate);
+      return true;
+    };
+    const stopDomMonitor = async () => {
+      if (!domMonitor) return;
+      const monitor = domMonitor;
+      domMonitor = null;
+      try {
+        await monitor.stop();
+      } catch {
+      }
+    };
     const onResponse = async (response) => {
       if (link) return;
       try {
@@ -3066,14 +3151,31 @@ var Share = {
         if (!text) return;
         const [candidate] = parseLinks(text, { identities }) || [];
         if (!candidate) return;
-        link = candidate;
-        payloadText = String(text || "");
-        if (resolveMatched) resolveMatched(candidate);
+        const matched = finalizeMatch(candidate, "response", text);
+        if (!matched) return;
         page.off("response", onResponse);
+        void stopDomMonitor();
       } catch {
       }
     };
-    page.on("response", onResponse);
+    if (enableDom) {
+      domMonitor = await Monitor.useShareLinkMonitor(page, {
+        identities,
+        selectors: domSelectors,
+        mode: domMode,
+        parseLinks,
+        onMatch: ({ link: domLink, rawDom }) => {
+          const matched = finalizeMatch(domLink, "dom", rawDom);
+          if (!matched) return;
+          if (enableResponse) {
+            page.off("response", onResponse);
+          }
+        }
+      });
+    }
+    if (enableResponse) {
+      page.on("response", onResponse);
+    }
     try {
       await performActions();
       if (!link && timeoutAfterActionMs > 0) {
@@ -3087,10 +3189,13 @@ var Share = {
         link,
         payloadText,
         payloadSnapshot,
-        source: link ? "response" : "none"
+        source
       };
     } finally {
-      page.off("response", onResponse);
+      if (enableResponse) {
+        page.off("response", onResponse);
+      }
+      await stopDomMonitor();
     }
   },
   /**