@skrillex1224/playwright-toolkit 2.0.90 → 2.0.92

package/dist/index.cjs

@@ -540,10 +540,11 @@ var Humanize = {
    * @param {Object} [options]
    * @param {number} [options.reactionDelay=250] - 反应延迟基础值 (ms)，实际 ±30% 抖动
    * @param {boolean} [options.throwOnMissing=true] - 元素不存在时是否抛出错误
+   * @param {boolean} [options.scrollIfNeeded=true] - 元素不在视口时是否自动滚动
    */
   async humanClick(page, target, options = {}) {
     const cursor = $GetCursor(page);
-    const { reactionDelay = 250, throwOnMissing = true } = options;
+    const { reactionDelay = 250, throwOnMissing = true, scrollIfNeeded = true } = options;
     const targetDesc = target == null ? "Current Position" : typeof target === "string" ? target : "ElementHandle";
     logger4.start("humanClick", `target=${targetDesc}`);
     try {
@@ -574,11 +575,38 @@ var Humanize = {
         logger4.warn("humanClick: \u65E0\u6CD5\u83B7\u53D6\u4F4D\u7F6E\uFF0C\u8DF3\u8FC7\u70B9\u51FB");
         return false;
       }
-      const x = box.x + box.width / 2 + (Math.random() - 0.5) * box.width * 0.3;
-      const y = box.y + box.height / 2 + (Math.random() - 0.5) * box.height * 0.3;
-      await cursor.actions.move({ x, y });
-      await (0, import_delay2.default)(this.jitterMs(reactionDelay, 0.4));
-      await cursor.actions.click();
+      const viewport = page.viewportSize() || { width: 1920, height: 1080 };
+      const isInViewport = box.x >= 0 && box.y >= 0 && box.x + box.width <= viewport.width && box.y + box.height <= viewport.height;
+      let originalScrollY = null;
+      if (!isInViewport && scrollIfNeeded) {
+        logger4.debug(`\u5143\u7D20\u4E0D\u5728\u89C6\u53E3\u5185\uFF0C\u6EDA\u52A8\u5230\u89C6\u53E3...`);
+        originalScrollY = await page.evaluate(() => window.scrollY);
+        await element.scrollIntoViewIfNeeded();
+        await (0, import_delay2.default)(this.jitterMs(300, 0.3));
+        const newBox = await element.boundingBox();
+        if (newBox) {
+          const x = newBox.x + newBox.width / 2 + (Math.random() - 0.5) * newBox.width * 0.3;
+          const y = newBox.y + newBox.height / 2 + (Math.random() - 0.5) * newBox.height * 0.3;
+          await cursor.actions.move({ x, y });
+          await (0, import_delay2.default)(this.jitterMs(reactionDelay, 0.4));
+          await cursor.actions.click();
+        } else {
+          throw new Error("\u6EDA\u52A8\u540E\u4ECD\u65E0\u6CD5\u83B7\u53D6\u5143\u7D20\u4F4D\u7F6E");
+        }
+        if (originalScrollY !== null) {
+          await (0, import_delay2.default)(this.jitterMs(200, 0.3));
+          await page.evaluate((scrollY) => {
+            window.scrollTo({ top: scrollY, behavior: "smooth" });
+          }, originalScrollY);
+          logger4.debug(`\u5DF2\u6EDA\u52A8\u56DE\u539F\u4F4D\u7F6E: ${originalScrollY}`);
+        }
+      } else {
+        const x = box.x + box.width / 2 + (Math.random() - 0.5) * box.width * 0.3;
+        const y = box.y + box.height / 2 + (Math.random() - 0.5) * box.height * 0.3;
+        await cursor.actions.move({ x, y });
+        await (0, import_delay2.default)(this.jitterMs(reactionDelay, 0.4));
+        await cursor.actions.click();
+      }
       logger4.success("humanClick");
       return true;
     } catch (error) {
@@ -1307,6 +1335,84 @@ var Blocking = {
       css: { name: "CSS \u6837\u5F0F", extensions: CSS_EXTENSIONS },
       other: { name: "\u5176\u4ED6\u8D44\u6E90", extensions: OTHER_EXTENSIONS }
     };
+  },
+  /**
+   * 设置 CDN 直连规则
+   * 对于指定域名的请求，使用 Node.js 原生 fetch 直连获取（绕过浏览器代理）
+   * 
+   * 适用场景：
+   * - 代理 IP 无法访问某些 CDN 域名（如 statics.moonshot.cn）
+   * - 需要加速静态资源加载
+   * 
+   * 注意事项：
+   * - 仅当代码运行在国内环境（本地/国内服务器）时，直连才能访问国内 CDN
+   * - 如果在海外服务器（如 Apify 云端）运行，直连仍使用海外 IP，可能依然无法访问
+   * 
+   * @param {import('playwright').Page} page - Playwright Page 对象
+   * @param {Object} [options] - 配置选项
+   * @param {string[]} [options.domains] - 需要直连的域名列表
+   * @param {string[]} [options.extensions] - 需要直连的扩展名列表（可选，默认 CSS/JS/字体）
+   * @param {boolean} [options.fallbackToProxy] - 直连失败时是否回退到代理（默认 true）
+   * @returns {Promise<void>}
+   */
+  async setupDirectConnect(page, options = {}) {
+    const {
+      domains = [],
+      extensions = [".css", ".js", ".woff", ".woff2", ".ttf", ".otf"],
+      fallbackToProxy = true
+    } = options;
+    if (domains.length === 0) {
+      logger9.warn("setupDirectConnect", "\u672A\u6307\u5B9A\u57DF\u540D\u5217\u8868\uFF0C\u8DF3\u8FC7\u76F4\u8FDE\u914D\u7F6E");
+      return;
+    }
+    logger9.start("setupDirectConnect", `\u57DF\u540D: [${domains.join(", ")}]`);
+    let directCount = 0;
+    let fallbackCount = 0;
+    await page.route("**/*", async (route) => {
+      const request = route.request();
+      const url = request.url();
+      const urlLower = url.toLowerCase();
+      const urlPath = urlLower.split("?")[0];
+      const matchesDomain = domains.some((domain) => url.includes(domain));
+      const matchesExtension = extensions.length === 0 || extensions.some((ext) => urlPath.endsWith(ext));
+      if (matchesDomain && matchesExtension) {
+        try {
+          const response = await fetch(url, {
+            method: request.method(),
+            headers: request.headers()
+            // 不传 agent 参数 = 直连（使用服务器本地网络）
+          });
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+          }
+          const buffer = await response.arrayBuffer();
+          const body = Buffer.from(buffer);
+          const headers = {};
+          response.headers.forEach((value, key) => {
+            headers[key] = value;
+          });
+          directCount++;
+          logger9.debug(`direct: ${url.substring(0, 100)}`);
+          await route.fulfill({
+            status: response.status,
+            headers,
+            body
+          });
+          return;
+        } catch (e) {
+          if (fallbackToProxy) {
+            fallbackCount++;
+            logger9.debug(`fallback: ${url.substring(0, 80)} (${e.message})`);
+            return route.continue();
+          } else {
+            logger9.warn("setupDirectConnect", `\u76F4\u8FDE\u5931\u8D25\u4E14\u4E0D\u56DE\u9000: ${url.substring(0, 80)}`);
+            return route.abort();
+          }
+        }
+      }
+      return route.continue();
+    });
+    logger9.success("setupDirectConnect", `\u6269\u5C55\u540D: [${extensions.join(", ")}]`);
   }
 };