@skrillex1224/playwright-toolkit 2.1.225 → 2.1.227

package/index.d.ts

@@ -208,6 +208,8 @@ export interface ApifyKitModule {
 export interface HumanTypeOptions {
     baseDelay?: number;
     jitterPercent?: number;
+    pauseProbability?: number;
+    pauseBase?: number;
 }
 
 export interface HumanClickOptions {
@@ -215,18 +217,59 @@ export interface HumanClickOptions {
     jitterPercent?: number;
     throwOnMissing?: boolean;
     scrollIfNeeded?: boolean;
+    restore?: boolean;
+}
+
+export interface HumanPressOptions {
+    reactionDelay?: number;
+    holdDelay?: number;
+    focusDelay?: number;
+    scrollIfNeeded?: boolean;
+    throwOnMissing?: boolean;
+    keyboardOptions?: Record<string, any>;
+}
+
+export interface MachineClickSelectorOptions {
+    targetParent?: boolean;
+    parent?: boolean;
+    pick?: 'first' | 'last';
+    last?: boolean;
+    visibleOnly?: boolean;
+    fallbackDomClick?: boolean;
+    forceMouse?: 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>;
+    click(page: Page, target: string | { x: number; y: number } | ElementHandle | Locator, options?: Record<string, any>): 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>;
 }
 
 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>;
     humanScroll(page: Page, target: string | ElementHandle | Locator, options?: Record<string, any>): Promise<{ element: ElementHandle | Locator | null; didScroll: boolean; restore?: (() => Promise<void>) | null }>;
     humanType(page: Page, selector: string, text: string, options?: HumanTypeOptions): Promise<void>;
+    humanPress(page: Page, key: string, options?: HumanPressOptions): Promise<boolean>;
+    humanPress(page: Page, target: string | ElementHandle | Locator, key: string, options?: HumanPressOptions): Promise<boolean>;
     humanClick(page: Page, target: string | ElementHandle | Locator | null | undefined, options?: HumanClickOptions): Promise<boolean>;
     humanClear(page: Page, selector: string): Promise<void>;
     warmUpBrowsing(page: Page, baseDuration?: number): Promise<void>;
     simulateGaze(page: Page, baseDurationMs?: number): Promise<void>;
+    randomSleep(page: Page, baseMs: number, jitterPercent?: number): Promise<void>;
     randomSleep(baseMs: number, jitterPercent?: number): Promise<void>;
     naturalScroll(page: Page, direction?: 'up' | 'down', distance?: number, baseSteps?: number): Promise<void>;
 }

package/package.json

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