@skrillex1224/playwright-toolkit 2.1.231 → 2.1.233

package/index.d.ts

@@ -229,7 +229,7 @@ export interface HumanPressOptions {
     keyboardOptions?: Record<string, any>;
 }
 
-export interface MachineClickSelectorOptions {
+export interface DeviceInputOptions {
     targetParent?: boolean;
     parent?: boolean;
     pick?: 'first' | 'last';
@@ -237,27 +237,50 @@ export interface MachineClickSelectorOptions {
     visibleOnly?: boolean;
     fallbackDomClick?: boolean;
     forceMouse?: boolean;
+    forceClick?: boolean;
     mouseOptions?: Record<string, any>;
     clickOptions?: Record<string, any>;
-}
-
-export interface MachineHumanizeModule {
-    clickPoint(page: Page, point: { x: number; y: number }, options?: MachineClickSelectorOptions): Promise<boolean>;
-    clickPoint(page: Page, x: number, y: number, options?: MachineClickSelectorOptions): Promise<boolean>;
+    tapOptions?: Record<string, any>;
+    keyboardOptions?: Record<string, any>;
+    visibleTimeoutMs?: number;
+    actionVisibleTimeoutMs?: number;
+    page?: Page;
+    steps?: number;
+    initialDelayMs?: number;
+    holdDelayMs?: number;
+    liftDelayMs?: number;
+    stepDelayMs?: number;
+    beforeReleaseDelayMs?: number;
+    afterReleaseDelayMs?: number;
+    allowMouseFallback?: boolean;
+}
+
+export interface DeviceInputModule {
+    device(page: Page): RuntimeDevice;
+    isMobile(page: Page): boolean;
+    clickPoint(page: Page, point: { x: number; y: number }, options?: DeviceInputOptions): Promise<boolean>;
+    clickPoint(page: Page, x: number, y: number, options?: DeviceInputOptions): Promise<boolean>;
+    tapPoint(page: Page, point: { x: number; y: number }, options?: DeviceInputOptions): Promise<boolean>;
+    tapPoint(page: Page, x: number, y: number, options?: DeviceInputOptions): Promise<boolean>;
     click(page: Page, target: string | { x: number; y: number } | ElementHandle | Locator, options?: Record<string, any>): Promise<boolean>;
+    tap(page: Page, target: string | { x: number; y: number } | ElementHandle | Locator, options?: Record<string, any>): Promise<boolean>;
+    move(page: Page, point: { x: number; y: number }, options?: DeviceInputOptions): Promise<boolean>;
+    move(page: Page, x: number, y: number, options?: DeviceInputOptions): Promise<boolean>;
     focus(page: Page, target: string | ElementHandle | Locator, options?: Record<string, any>): Promise<boolean>;
     fill(page: Page, target: string | ElementHandle | Locator, value: string, options?: Record<string, any>): Promise<boolean>;
     type(page: Page, text: string, options?: Record<string, any>): Promise<boolean>;
     type(page: Page, target: string | ElementHandle | Locator, text: string, options?: Record<string, any>): Promise<boolean>;
     keyboardType(page: Page, text: string, options?: Record<string, any>): Promise<boolean>;
-    selectorCenterPoint(page: Page, selector: string, options?: MachineClickSelectorOptions): Promise<{ x: number; y: number } | null>;
-    domClick(page: Page, selector: string, options?: MachineClickSelectorOptions): Promise<boolean>;
-    clickSelectorCenter(page: Page, selector: string, options?: MachineClickSelectorOptions): Promise<boolean>;
+    press(page: Page, key: string, options?: DeviceInputOptions): Promise<boolean>;
+    press(page: Page, target: string | ElementHandle | Locator, key: string, options?: DeviceInputOptions): Promise<boolean>;
+    selectorCenterPoint(page: Page, selector: string, options?: DeviceInputOptions): Promise<{ x: number; y: number } | null>;
+    domClick(page: Page, selector: string, options?: DeviceInputOptions): Promise<boolean>;
+    clickSelectorCenter(page: Page, selector: string, options?: DeviceInputOptions): Promise<boolean>;
+    clickText(frameOrPage: Page | any, texts: string[], options?: DeviceInputOptions): Promise<boolean>;
+    drag(page: Page, sourceLocator: Locator, targetLocator: Locator, options?: DeviceInputOptions): Promise<boolean>;
 }
 
 export interface HumanizeModule {
-    /** M = Machine: native/mechanical operations for compatibility paths. */
-    M: MachineHumanizeModule;
     initializeCursor(page: Page): Promise<void>;
     jitterMs(base: number, jitterPercent?: number): number;
     humanMove(page: Page, target: string | { x: number; y: number } | ElementHandle | Locator): Promise<boolean>;
@@ -587,8 +610,6 @@ export interface ShareScreenCompressionOptions {
 }
 
 export interface ShareScreenCaptureOptions {
-    /** 额外缓冲高度；默认按视口高度自动计算（25%，夹在 120-320px），传 0 可关闭。 */
-    buffer?: number;
     /** 截图后是否恢复页面高度和样式 (默认: false) */
     restore?: boolean;
     /** 最大截图高度 (默认: 8000px) */
@@ -758,6 +779,7 @@ export interface ByPassModule {
 export interface PlaywrightToolKit {
     ApifyKit: ApifyKitModule;
     AntiCheat: AntiDetectModule;
+    DeviceInput: DeviceInputModule;
     Humanize: HumanizeModule;
     Launch: LaunchModule;
     LiveView: LiveViewModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.1.231",
+  "version": "2.1.233",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",