@skrillex1224/playwright-toolkit 2.1.223 → 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;
@@ -507,7 +527,7 @@ export interface ScreenshotWatermarkifyOptions {
 export interface ShareScreenCompressionOptions {
     /** 是否启用截图压缩，默认开启。 */
     enabled?: boolean;
-    /** 返回 base64 字符串的最大字节数，默认 8MiB。 */
+    /** 返回 base64 字符串的最大字节数，默认 5MiB。 */
     maxBytes?: number;
     /** maxBytes 的别名。 */
     maxBase64Bytes?: number;
@@ -530,7 +550,7 @@ export interface ShareScreenCaptureOptions {
     restore?: boolean;
     /** 最大截图高度 (默认: 8000px) */
     maxHeight?: number;
-    /** 返回 base64 字符串的最大字节数，默认 8MiB。 */
+    /** 返回 base64 字符串的最大字节数，默认 5MiB。 */
     maxBytes?: number;
     /** maxBytes 的别名。 */
     maxBase64Bytes?: number;

package/package.json

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