@xbrowser/cli 1.10.0 → 1.12.0

package/dist/{human-interaction-5AO42MBA.js → human-interaction-4YR2N6R6.js}

@@ -1,7 +1,7 @@
 import {
   HumanInteractionManager
-} from "./chunk-MWFHZUIY.js";
-import "./chunk-IIM5GOD7.js";
+} from "./chunk-OMU63E6J.js";
+import "./chunk-HBMEFSTB.js";
 import "./chunk-KFQGP6VL.js";
 export {
   HumanInteractionManager

package/dist/{human-interaction-C5OEGXGO.js → human-interaction-Y5IDH6LD.js}

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-DWDXEGVK.js";
+} from "./chunk-NKW4A74J.js";
 import "./chunk-KFQGP6VL.js";
 export {
   HumanInteractionManager

package/dist/{human-interaction-ISXZTAYY.js → human-interaction-ZUTR5AC2.js}

@@ -1,7 +1,7 @@
 import {
   HumanInteractionManager
-} from "./chunk-SQHSZENE.js";
-import "./chunk-BNO7OKO4.js";
+} from "./chunk-TEXCXIBW.js";
+import "./chunk-ZTHE5RBZ.js";
 import "./chunk-KFQGP6VL.js";
 export {
   HumanInteractionManager

package/dist/index.d.ts

@@ -172,7 +172,15 @@ interface XBPage {
         height: number;
     }): Promise<void>;
     addInitScript(script: string): Promise<void>;
+    /** 覆盖当前页会话的 User-Agent（Network.setUserAgentOverride，会话级持久） */
+    setUserAgent(userAgent: string): Promise<void>;
     discoverFrames(): Promise<XBFrame[]>;
+    /**
+     * 在 URL 含 urlIncludes 的 iframe 上下文中执行表达式。
+     * 同进程 iframe 走 contextId；跨域 OOPIF 走 Target auto-attach。
+     * 绕过页面同源策略（CDP 是调试通道）——跨域嵌入内容读写的唯一路径。
+     */
+    evaluateInFrame<R = unknown>(urlIncludes: string, expression: string): Promise<R>;
     bringToFront(): Promise<void>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<void>;
     setOfflineMode(offline: boolean): Promise<void>;
@@ -288,6 +296,7 @@ interface XBMouse {
         button?: 'left' | 'right' | 'middle';
         clickCount?: number;
         delay?: number;
+        stealth?: boolean;
     }): Promise<void>;
     dblclick(x: number, y: number, opts?: {
         button?: 'left' | 'right' | 'middle';
@@ -311,6 +320,7 @@ interface XBKeyboard {
     up(key: string): Promise<void>;
     type(text: string, opts?: {
         delay?: number;
+        stealth?: boolean;
     }): Promise<void>;
     insertText(text: string): Promise<void>;
 }