@skrillex1224/playwright-toolkit 2.1.224 → 2.1.225

package/index.d.ts

@@ -1,4 +1,4 @@
-import type { Page, BrowserContext, Browser, ElementHandle, Response } from 'playwright';
+import type { Page, BrowserContext, Browser, ElementHandle, Locator, Response } from 'playwright';
 
 // =============================================================================
 // Constants
@@ -22,9 +22,16 @@ export interface ConstantsModule {
     Code: CodeType;
     Status: StatusType;
     PresetOfLiveViewKey: string;
+    Device: {
+        Desktop: 'desktop';
+        Mobile: 'mobile';
+    };
+    normalizeDevice(value?: unknown, fallback?: RuntimeDevice): RuntimeDevice;
     ActorInfo: Record<string, ActorInfoItem>;
 }
 
+export type RuntimeDevice = 'desktop' | 'mobile';
+
 export interface ActorShareInfo {
     mode: 'dom' | 'response';
     prefix: string;
@@ -36,6 +43,7 @@ export interface ActorInfoItem {
     name: string;
     icon: string;
     domain: string;
+    device: RuntimeDevice;
     protocol: string;
     path: string;
     share: ActorShareInfo;
@@ -212,11 +220,15 @@ export interface HumanClickOptions {
 export interface HumanizeModule {
     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>;
-    humanClick(page: Page, target: string | ElementHandle, options?: HumanClickOptions): Promise<void>;
+    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(baseMs: number, jitterPercent?: number): Promise<void>;
+    naturalScroll(page: Page, direction?: 'up' | 'down', distance?: number, baseSteps?: number): Promise<void>;
 }
 
 // =============================================================================
@@ -239,15 +251,21 @@ export interface AntiDetectApplyOptions {
     permissions?: string[];
 }
 
+export interface FingerprintGeneratorRuntimeOptions {
+    locale?: string;
+    browserMajorVersion?: number;
+    device?: RuntimeDevice;
+}
+
 export interface AntiDetectModule {
     getBaseConfig(): AntiDetectConfig;
-    getFingerprintGeneratorOptions(): Record<string, any>;
-    getLaunchArgs(): string[];
+    getFingerprintGeneratorOptions(options?: FingerprintGeneratorRuntimeOptions): Record<string, any>;
+    getLaunchArgs(options?: { locale?: string }): string[];
     getAdvancedLaunchArgs(): string[];
     applyContext(context: BrowserContext, options?: AntiDetectApplyOptions): Promise<void>;
     applyPage(page: Page, options?: AntiDetectApplyOptions): Promise<void>;
     syncViewportWithScreen(page: Page): Promise<void>;
-    getTlsFingerprintOptions(userAgent?: string, acceptLanguage?: string): Record<string, any>;
+    getTlsFingerprintOptions(userAgent?: string, acceptLanguage?: string, options?: FingerprintGeneratorRuntimeOptions): Record<string, any>;
     applyLocaleHeaders(headers: Record<string, string>, acceptLanguage?: string): Record<string, string>;
 }
 
@@ -367,6 +385,7 @@ export interface UtilsModule {
 
 export interface RuntimeEnvState {
     actor: string;
+    device: RuntimeDevice;
     runtime: Record<string, any>;
     envId: string;
     query: string;
@@ -412,6 +431,7 @@ export interface RuntimeEnvModule {
     buildRuntimeEnvFromSnapshot(snapshot?: RuntimeEnvSnapshot, options?: { browserProfileCore?: Record<string, any> }): Record<string, any> | null;
     buildEnvPatchFromSnapshot(snapshot?: RuntimeEnvSnapshot, options?: { browserProfileCore?: Record<string, any> }): Record<string, any> | null;
     mergeEnvPatches(...patches: Array<Record<string, any> | null | undefined>): Record<string, any> | null;
+    normalizeDevice(value?: unknown, fallback?: RuntimeDevice): RuntimeDevice;
     hasLoginState(source?: Record<string, any>, actor?: string): boolean;
     rememberState(source?: Record<string, any>): RuntimeEnvState | null;
     peekRememberedState(): RuntimeEnvState | null;

package/package.json

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