@skrillex1224/playwright-toolkit 2.1.207 → 2.1.208

package/index.d.ts

@@ -1,4 +1,4 @@
-import type { Page, BrowserContext, Browser, ElementHandle } from 'playwright';
+import type { Page, BrowserContext, Browser, ElementHandle, Response } from 'playwright';
 
 // =============================================================================
 // Constants
@@ -449,6 +449,57 @@ export interface ShareLinkCaptureResult {
     source: 'response' | 'dom' | 'none';
 }
 
+export interface ScreenshotWatermarkifyResolverContext {
+    page: Page;
+    response?: Response | null;
+    url: string;
+    hostname: string;
+    title: string;
+    query?: string;
+    taskId?: string;
+    serverAddr?: { ipAddress: string; port: number } | null;
+    signal?: AbortSignal;
+}
+
+export interface ScreenshotWatermarkifyResolverResult {
+    ip?: string;
+    location?: string;
+}
+
+export type ScreenshotWatermarkifyResolver = (
+    context: ScreenshotWatermarkifyResolverContext
+) => Promise<ScreenshotWatermarkifyResolverResult | null> | ScreenshotWatermarkifyResolverResult | null;
+
+export interface ScreenshotWatermarkifyWatermarkOptions {
+    enabled?: boolean;
+    opacity?: number;
+    rotateDeg?: number;
+    cellWidth?: number;
+    cellHeight?: number;
+}
+
+export interface ScreenshotWatermarkifyStripOptions {
+    enabled?: boolean;
+}
+
+export interface ScreenshotWatermarkifyOptions {
+    enabled?: boolean;
+    timezoneOffsetHours?: number;
+    response?: Response | null;
+    ip?: string;
+    location?: string;
+    query?: string;
+    taskId?: string;
+    /** 默认会在同一浏览器上下文中访问 http://myip.ipip.net 补充 IP/Loc。 */
+    ipLookup?: boolean;
+    /** 内置 IP/Loc 查询超时，默认 10000ms。 */
+    ipLookupTimeoutMs?: number;
+    resolver?: ScreenshotWatermarkifyResolver | null;
+    resolverTimeoutMs?: number;
+    watermark?: boolean | ScreenshotWatermarkifyWatermarkOptions;
+    strip?: boolean | ScreenshotWatermarkifyStripOptions;
+}
+
 export interface ShareScreenCaptureOptions {
     /** 额外缓冲高度 (默认: 视口高度的一半) */
     buffer?: number;
@@ -456,6 +507,8 @@ export interface ShareScreenCaptureOptions {
     restore?: boolean;
     /** 最大截图高度 (默认: 8000px) */
     maxHeight?: number;
+    /** 截图水印增强流程，默认开启；传 false 可关闭。 */
+    watermarkify?: boolean | ScreenshotWatermarkifyOptions;
 }
 
 export interface ShareModule {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.1.207",
+  "version": "2.1.208",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -45,6 +45,7 @@
     "access": "public"
   },
   "dependencies": {
+    "delay": "^4.4.1",
     "express": "^4.18.2",
     "fingerprint-generator": "^2.1.79",
     "fingerprint-injector": "^2.1.79",
@@ -56,7 +57,6 @@
   "peerDependencies": {
     "apify": "*",
     "crawlee": "*",
-    "delay": "*",
     "ghost-cursor-playwright": "*",
     "playwright": "*"
   },