agent-browser 0.19.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/README.md +36 -82
  2. package/bin/agent-browser-darwin-arm64 +0 -0
  3. package/bin/agent-browser-darwin-x64 +0 -0
  4. package/bin/agent-browser-linux-arm64 +0 -0
  5. package/bin/agent-browser-linux-x64 +0 -0
  6. package/bin/agent-browser-win32-x64.exe +0 -0
  7. package/package.json +6 -49
  8. package/scripts/postinstall.js +12 -15
  9. package/skills/agent-browser/SKILL.md +9 -18
  10. package/skills/electron/SKILL.md +5 -5
  11. package/dist/action-policy.d.ts +0 -14
  12. package/dist/action-policy.d.ts.map +0 -1
  13. package/dist/action-policy.js +0 -253
  14. package/dist/action-policy.js.map +0 -1
  15. package/dist/actions.d.ts +0 -18
  16. package/dist/actions.d.ts.map +0 -1
  17. package/dist/actions.js +0 -2121
  18. package/dist/actions.js.map +0 -1
  19. package/dist/auth-cli.d.ts +0 -2
  20. package/dist/auth-cli.d.ts.map +0 -1
  21. package/dist/auth-cli.js +0 -97
  22. package/dist/auth-cli.js.map +0 -1
  23. package/dist/auth-vault.d.ts +0 -36
  24. package/dist/auth-vault.d.ts.map +0 -1
  25. package/dist/auth-vault.js +0 -125
  26. package/dist/auth-vault.js.map +0 -1
  27. package/dist/browser.d.ts +0 -629
  28. package/dist/browser.d.ts.map +0 -1
  29. package/dist/browser.js +0 -2342
  30. package/dist/browser.js.map +0 -1
  31. package/dist/confirmation.d.ts +0 -8
  32. package/dist/confirmation.d.ts.map +0 -1
  33. package/dist/confirmation.js +0 -30
  34. package/dist/confirmation.js.map +0 -1
  35. package/dist/daemon.d.ts +0 -71
  36. package/dist/daemon.d.ts.map +0 -1
  37. package/dist/daemon.js +0 -669
  38. package/dist/daemon.js.map +0 -1
  39. package/dist/diff.d.ts +0 -18
  40. package/dist/diff.d.ts.map +0 -1
  41. package/dist/diff.js +0 -271
  42. package/dist/diff.js.map +0 -1
  43. package/dist/domain-filter.d.ts +0 -28
  44. package/dist/domain-filter.d.ts.map +0 -1
  45. package/dist/domain-filter.js +0 -149
  46. package/dist/domain-filter.js.map +0 -1
  47. package/dist/encryption.d.ts +0 -73
  48. package/dist/encryption.d.ts.map +0 -1
  49. package/dist/encryption.js +0 -171
  50. package/dist/encryption.js.map +0 -1
  51. package/dist/index.d.ts +0 -7
  52. package/dist/index.d.ts.map +0 -1
  53. package/dist/index.js +0 -5
  54. package/dist/index.js.map +0 -1
  55. package/dist/inspect-server.d.ts +0 -26
  56. package/dist/inspect-server.d.ts.map +0 -1
  57. package/dist/inspect-server.js +0 -218
  58. package/dist/inspect-server.js.map +0 -1
  59. package/dist/ios-actions.d.ts +0 -11
  60. package/dist/ios-actions.d.ts.map +0 -1
  61. package/dist/ios-actions.js +0 -228
  62. package/dist/ios-actions.js.map +0 -1
  63. package/dist/ios-manager.d.ts +0 -266
  64. package/dist/ios-manager.d.ts.map +0 -1
  65. package/dist/ios-manager.js +0 -1073
  66. package/dist/ios-manager.js.map +0 -1
  67. package/dist/protocol.d.ts +0 -28
  68. package/dist/protocol.d.ts.map +0 -1
  69. package/dist/protocol.js +0 -988
  70. package/dist/protocol.js.map +0 -1
  71. package/dist/snapshot.d.ts +0 -67
  72. package/dist/snapshot.d.ts.map +0 -1
  73. package/dist/snapshot.js +0 -514
  74. package/dist/snapshot.js.map +0 -1
  75. package/dist/state-utils.d.ts +0 -77
  76. package/dist/state-utils.d.ts.map +0 -1
  77. package/dist/state-utils.js +0 -178
  78. package/dist/state-utils.js.map +0 -1
  79. package/dist/stream-server.d.ts +0 -117
  80. package/dist/stream-server.d.ts.map +0 -1
  81. package/dist/stream-server.js +0 -309
  82. package/dist/stream-server.js.map +0 -1
  83. package/dist/types.d.ts +0 -927
  84. package/dist/types.d.ts.map +0 -1
  85. package/dist/types.js +0 -2
  86. package/dist/types.js.map +0 -1
package/dist/browser.d.ts DELETED
@@ -1,629 +0,0 @@
1
- import { devices, type Browser, type BrowserContext, type Page, type Frame, type Locator, type CDPSession } from 'playwright-core';
2
- import type { LaunchCommand } from './types.js';
3
- import type { InspectServer } from './inspect-server.js';
4
- import { type RefMap, type EnhancedSnapshot } from './snapshot.js';
5
- /**
6
- * Returns the default Playwright timeout in milliseconds for standard operations.
7
- * Can be overridden via the AGENT_BROWSER_DEFAULT_TIMEOUT environment variable.
8
- * Default is 25s, which is below the CLI's 30s IPC read timeout to ensure
9
- * Playwright errors are returned before the CLI gives up with EAGAIN.
10
- * Recording contexts use a shorter fixed timeout (10s) and are not affected.
11
- */
12
- export declare function getDefaultTimeout(): number;
13
- /**
14
- * Handles boolean env vars and parsing (e.g., "true", "1", "false", "0"),
15
- * with a default value if not set or invalid
16
- */
17
- export declare function parseBooleanEnvVar(name: string, defaultValue: boolean): boolean;
18
- export interface ScreencastFrame {
19
- data: string;
20
- metadata: {
21
- offsetTop: number;
22
- pageScaleFactor: number;
23
- deviceWidth: number;
24
- deviceHeight: number;
25
- scrollOffsetX: number;
26
- scrollOffsetY: number;
27
- timestamp?: number;
28
- };
29
- sessionId: number;
30
- }
31
- export interface ScreencastOptions {
32
- format?: 'jpeg' | 'png';
33
- quality?: number;
34
- maxWidth?: number;
35
- maxHeight?: number;
36
- everyNthFrame?: number;
37
- }
38
- export interface NavigateOptions {
39
- waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
40
- headers?: Record<string, string>;
41
- }
42
- export type BrowserLaunchOptions = Pick<LaunchCommand, 'headless' | 'viewport' | 'browser' | 'headers' | 'executablePath' | 'cdpPort' | 'cdpUrl' | 'autoConnect' | 'extensions' | 'profile' | 'storageState' | 'proxy' | 'args' | 'userAgent' | 'provider' | 'ignoreHTTPSErrors' | 'allowFileAccess' | 'colorScheme' | 'downloadPath' | 'allowedDomains' | 'autoStateFilePath'>;
43
- interface TrackedRequest {
44
- url: string;
45
- method: string;
46
- headers: Record<string, string>;
47
- timestamp: number;
48
- resourceType: string;
49
- }
50
- interface ConsoleMessage {
51
- type: string;
52
- text: string;
53
- timestamp: number;
54
- }
55
- interface PageError {
56
- message: string;
57
- timestamp: number;
58
- }
59
- /**
60
- * Manages the Playwright browser lifecycle with multiple tabs/windows
61
- */
62
- export declare class BrowserManager {
63
- private browser;
64
- private cdpEndpoint;
65
- private resolvedWsUrl;
66
- private isPersistentContext;
67
- private browserbaseSessionId;
68
- private browserbaseApiKey;
69
- private browserUseSessionId;
70
- private browserUseApiKey;
71
- private kernelSessionId;
72
- private kernelApiKey;
73
- private browserlessStopUrl;
74
- private contexts;
75
- private pages;
76
- private activePageIndex;
77
- private activeFrame;
78
- private dialogHandler;
79
- private trackedRequests;
80
- private routes;
81
- private consoleMessages;
82
- private pageErrors;
83
- private isRecordingHar;
84
- private refMap;
85
- private lastSnapshot;
86
- private scopedHeaderRoutes;
87
- private colorScheme;
88
- private downloadPath;
89
- private allowedDomains;
90
- private inspectServer;
91
- stopInspectServer(): void;
92
- setInspectServer(server: InspectServer): void;
93
- /**
94
- * Set the persistent color scheme preference.
95
- * Applied automatically to all new pages and contexts.
96
- */
97
- setColorScheme(scheme: 'light' | 'dark' | 'no-preference' | null): void;
98
- private cdpSession;
99
- private screencastActive;
100
- private screencastSessionId;
101
- private frameCallback;
102
- private screencastFrameHandler;
103
- private recordingContext;
104
- private recordingPage;
105
- private recordingOutputPath;
106
- private recordingTempDir;
107
- private launchWarnings;
108
- /**
109
- * Get and clear launch warnings (e.g., decryption failures)
110
- */
111
- getAndClearWarnings(): string[];
112
- private static readonly MAX_PROFILE_EVENTS;
113
- private profilingActive;
114
- private profileChunks;
115
- private profileEventsDropped;
116
- private profileCompleteResolver;
117
- private profileDataHandler;
118
- private profileCompleteHandler;
119
- /**
120
- * Check if browser is launched
121
- */
122
- isLaunched(): boolean;
123
- getCdpUrl(): string | null;
124
- /**
125
- * Get enhanced snapshot with refs and cache the ref map
126
- */
127
- getSnapshot(options?: {
128
- interactive?: boolean;
129
- cursor?: boolean;
130
- maxDepth?: number;
131
- compact?: boolean;
132
- selector?: string;
133
- }): Promise<EnhancedSnapshot>;
134
- /**
135
- * Get the last snapshot tree text (empty string if no snapshot has been taken)
136
- */
137
- getLastSnapshot(): string;
138
- /**
139
- * Update the stored snapshot (used by diff to keep the baseline current)
140
- */
141
- setLastSnapshot(snapshot: string): void;
142
- /**
143
- * Get the cached ref map from last snapshot
144
- */
145
- getRefMap(): RefMap;
146
- /**
147
- * Get a locator from a ref (e.g., "e1", "@e1", "ref=e1")
148
- * Returns null if ref doesn't exist or is invalid
149
- */
150
- getLocatorFromRef(refArg: string): Locator | null;
151
- /**
152
- * Check if a selector looks like a ref
153
- */
154
- isRef(selector: string): boolean;
155
- /**
156
- * Install the domain filter on a context if an allowlist is configured.
157
- * Should be called before any pages navigate on the context.
158
- */
159
- private ensureDomainFilter;
160
- /**
161
- * After installing the domain filter, verify existing pages are on allowed
162
- * domains. Pages that pre-date the filter (e.g. CDP/cloud connect) may have
163
- * already navigated to disallowed domains. Navigate them to about:blank.
164
- */
165
- private sanitizeExistingPages;
166
- /**
167
- * Check if a URL is allowed by the domain allowlist.
168
- * Throws if the URL's domain is blocked. No-op if no allowlist is set.
169
- * Blocks non-http(s) schemes and unparseable URLs by default.
170
- */
171
- checkDomainAllowed(url: string): void;
172
- /**
173
- * Get locator - supports both refs and regular selectors
174
- */
175
- getLocator(selectorOrRef: string): Locator;
176
- /**
177
- * Check if the browser has any usable pages
178
- */
179
- hasPages(): boolean;
180
- /**
181
- * Ensure at least one page exists. If the browser is launched but all pages
182
- * were closed (stale session), creates a new page on the existing context.
183
- * No-op if pages already exist.
184
- */
185
- ensurePage(): Promise<void>;
186
- /**
187
- * Get the current active page, throws if not launched
188
- */
189
- getPage(): Page;
190
- /**
191
- * Get the current frame (or page's main frame if no frame is selected)
192
- */
193
- getFrame(): Frame;
194
- /**
195
- * Switch to a frame by selector, name, or URL
196
- */
197
- switchToFrame(options: {
198
- selector?: string;
199
- name?: string;
200
- url?: string;
201
- }): Promise<void>;
202
- /**
203
- * Navigate the active page to a URL and return the resolved URL + title.
204
- * If the browser is launched but all pages have been closed, a new page is
205
- * created automatically before navigating (stale-session recovery).
206
- */
207
- navigate(url: string, options?: NavigateOptions): Promise<{
208
- url: string;
209
- title: string;
210
- }>;
211
- /**
212
- * Get the active page URL.
213
- */
214
- getUrl(): Promise<string>;
215
- /**
216
- * Get the active page title.
217
- */
218
- getTitle(): Promise<string>;
219
- /**
220
- * Switch back to main frame
221
- */
222
- switchToMainFrame(): void;
223
- /**
224
- * Set up dialog handler
225
- */
226
- setDialogHandler(response: 'accept' | 'dismiss', promptText?: string): void;
227
- /**
228
- * Clear dialog handler
229
- */
230
- clearDialogHandler(): void;
231
- /**
232
- * Start tracking requests
233
- */
234
- startRequestTracking(): void;
235
- /**
236
- * Get tracked requests
237
- */
238
- getRequests(filter?: string): TrackedRequest[];
239
- /**
240
- * Clear tracked requests
241
- */
242
- clearRequests(): void;
243
- /**
244
- * Add a route to intercept requests
245
- */
246
- addRoute(url: string, options: {
247
- response?: {
248
- status?: number;
249
- body?: string;
250
- contentType?: string;
251
- headers?: Record<string, string>;
252
- };
253
- abort?: boolean;
254
- }): Promise<void>;
255
- /**
256
- * Remove a route
257
- */
258
- removeRoute(url?: string): Promise<void>;
259
- /**
260
- * Set geolocation
261
- */
262
- setGeolocation(latitude: number, longitude: number, accuracy?: number): Promise<void>;
263
- /**
264
- * Set permissions
265
- */
266
- setPermissions(permissions: string[], grant: boolean): Promise<void>;
267
- /**
268
- * Set viewport
269
- */
270
- setViewport(width: number, height: number): Promise<void>;
271
- /**
272
- * Set device scale factor (devicePixelRatio) via CDP
273
- * This sets window.devicePixelRatio which affects how the page renders and responds to media queries
274
- *
275
- * Note: When using CDP to set deviceScaleFactor, screenshots will be at logical pixel dimensions
276
- * (viewport size), not physical pixel dimensions (viewport × scale). This is a Playwright limitation
277
- * when using CDP emulation on existing contexts. For true HiDPI screenshots with physical pixels,
278
- * deviceScaleFactor must be set at context creation time.
279
- *
280
- * Must be called after setViewport to work correctly
281
- */
282
- setDeviceScaleFactor(deviceScaleFactor: number, width: number, height: number, mobile?: boolean): Promise<void>;
283
- /**
284
- * Clear device metrics override to restore default devicePixelRatio
285
- */
286
- clearDeviceMetricsOverride(): Promise<void>;
287
- /**
288
- * Get device descriptor
289
- */
290
- getDevice(deviceName: string): (typeof devices)[keyof typeof devices] | undefined;
291
- /**
292
- * List available devices
293
- */
294
- listDevices(): string[];
295
- /**
296
- * Start console message tracking
297
- */
298
- startConsoleTracking(): void;
299
- /**
300
- * Get console messages
301
- */
302
- getConsoleMessages(): ConsoleMessage[];
303
- /**
304
- * Clear console messages
305
- */
306
- clearConsoleMessages(): void;
307
- /**
308
- * Start error tracking
309
- */
310
- startErrorTracking(): void;
311
- /**
312
- * Get page errors
313
- */
314
- getPageErrors(): PageError[];
315
- /**
316
- * Clear page errors
317
- */
318
- clearPageErrors(): void;
319
- /**
320
- * Start HAR recording
321
- */
322
- startHarRecording(): Promise<void>;
323
- /**
324
- * Check if HAR recording
325
- */
326
- isHarRecording(): boolean;
327
- /**
328
- * Set offline mode
329
- */
330
- setOffline(offline: boolean): Promise<void>;
331
- /**
332
- * Set extra HTTP headers (global - all requests)
333
- */
334
- setExtraHeaders(headers: Record<string, string>): Promise<void>;
335
- /**
336
- * Set scoped HTTP headers (only for requests matching the origin)
337
- * Uses route interception to add headers only to matching requests
338
- */
339
- setScopedHeaders(origin: string, headers: Record<string, string>): Promise<void>;
340
- /**
341
- * Clear scoped headers for an origin (or all if no origin specified)
342
- */
343
- clearScopedHeaders(origin?: string): Promise<void>;
344
- /**
345
- * Start tracing
346
- */
347
- startTracing(options: {
348
- screenshots?: boolean;
349
- snapshots?: boolean;
350
- }): Promise<void>;
351
- /**
352
- * Stop tracing and save
353
- */
354
- stopTracing(path?: string): Promise<void>;
355
- /**
356
- * Get the current browser context (first context)
357
- */
358
- getContext(): BrowserContext | null;
359
- /**
360
- * Save storage state (cookies, localStorage, etc.)
361
- */
362
- saveStorageState(path: string): Promise<void>;
363
- /**
364
- * Get all pages
365
- */
366
- getPages(): Page[];
367
- /**
368
- * Get current page index
369
- */
370
- getActiveIndex(): number;
371
- /**
372
- * Get the current browser instance
373
- */
374
- getBrowser(): Browser | null;
375
- /**
376
- * Check if an existing CDP connection is still alive
377
- * by verifying we can access browser contexts and that at least one has pages
378
- */
379
- private isCdpConnectionAlive;
380
- /**
381
- * Check if CDP connection needs to be re-established
382
- */
383
- private needsCdpReconnect;
384
- /**
385
- * Close a Browserbase session via API
386
- */
387
- private closeBrowserbaseSession;
388
- /**
389
- * Close a Browser Use session via API
390
- */
391
- private closeBrowserUseSession;
392
- /**
393
- * Close a Kernel session via API
394
- */
395
- private closeKernelSession;
396
- /**
397
- * Close a Browserless session via its stop URL
398
- */
399
- private closeBrowserlessSession;
400
- /**
401
- * Connect to Browserbase remote browser via CDP.
402
- * Requires BROWSERBASE_API_KEY environment variable.
403
- */
404
- private connectToBrowserbase;
405
- /**
406
- * Find or create a Kernel profile by name.
407
- * Returns the profile object if successful.
408
- */
409
- private findOrCreateKernelProfile;
410
- /**
411
- * Connect to Kernel remote browser via CDP.
412
- * Uses KERNEL_API_KEY environment variable for authentication when set.
413
- * When running inside environments with external credential injection
414
- * (e.g. Vercel Sandbox credentials brokering), the API key can be omitted
415
- * and auth headers will be injected at the network layer.
416
- */
417
- private connectToKernel;
418
- /**
419
- * Connect to Browser Use remote browser via CDP.
420
- * Requires BROWSER_USE_API_KEY environment variable.
421
- */
422
- private connectToBrowserUse;
423
- /**
424
- * Connect to Browserless remote browser via CDP.
425
- * Requires BROWSERLESS_API_KEY environment variable.
426
- */
427
- private connectToBrowserless;
428
- /**
429
- * Launch the browser with the specified options
430
- * If already launched, this is a no-op (browser stays open)
431
- */
432
- launch(options: BrowserLaunchOptions): Promise<void>;
433
- /**
434
- * Connect to a running browser via CDP (Chrome DevTools Protocol)
435
- * @param cdpEndpoint Either a port number (as string) or a full WebSocket URL (ws:// or wss://)
436
- */
437
- private connectViaCDP;
438
- /**
439
- * Get Chrome's default user data directory paths for the current platform.
440
- * Returns an array of candidate paths to check (stable, then beta/canary).
441
- */
442
- private getChromeUserDataDirs;
443
- /**
444
- * Try to read the DevToolsActivePort file from a Chrome user data directory.
445
- * Returns { port, wsPath } if found, or null if not available.
446
- */
447
- private readDevToolsActivePort;
448
- /**
449
- * Try to discover a Chrome CDP endpoint by querying an HTTP debug port.
450
- * Returns the WebSocket debugger URL if available.
451
- */
452
- private probeDebugPort;
453
- /**
454
- * Auto-discover and connect to a running Chrome/Chromium instance.
455
- *
456
- * Discovery strategy:
457
- * 1. Read DevToolsActivePort from Chrome's default user data directories
458
- * 2. If found, connect using the port and WebSocket path from that file
459
- * 3. If not found, probe common debugging ports (9222, 9229)
460
- * 4. If a port responds, connect via CDP
461
- */
462
- private autoConnectViaCDP;
463
- /**
464
- * Set up console, error, and close tracking for a page
465
- */
466
- private setupPageTracking;
467
- /**
468
- * Set up tracking for new pages in a context (for CDP connections and popups/new tabs)
469
- * This handles pages created externally (e.g., via target="_blank" links, window.open)
470
- */
471
- private setupContextTracking;
472
- /**
473
- * Create a new tab in the current context
474
- */
475
- newTab(): Promise<{
476
- index: number;
477
- total: number;
478
- }>;
479
- /**
480
- * Create a new window (new context)
481
- */
482
- newWindow(viewport?: {
483
- width: number;
484
- height: number;
485
- } | null): Promise<{
486
- index: number;
487
- total: number;
488
- }>;
489
- /**
490
- * Invalidate the current CDP session (must be called before switching pages)
491
- * This ensures screencast and input injection work correctly after tab switch
492
- */
493
- private invalidateCDPSession;
494
- /**
495
- * Switch to a specific tab/page by index
496
- */
497
- switchTo(index: number): Promise<{
498
- index: number;
499
- url: string;
500
- title: string;
501
- }>;
502
- /**
503
- * Close a specific tab/page
504
- */
505
- closeTab(index?: number): Promise<{
506
- closed: number;
507
- remaining: number;
508
- }>;
509
- /**
510
- * List all tabs with their info
511
- */
512
- listTabs(): Promise<Array<{
513
- index: number;
514
- url: string;
515
- title: string;
516
- active: boolean;
517
- }>>;
518
- /**
519
- * Get or create a CDP session for the current page
520
- * Only works with Chromium-based browsers
521
- */
522
- getCDPSession(): Promise<CDPSession>;
523
- /**
524
- * Check if screencast is currently active
525
- */
526
- isScreencasting(): boolean;
527
- /**
528
- * Start screencast - streams viewport frames via CDP
529
- * @param callback Function called for each frame
530
- * @param options Screencast options
531
- */
532
- startScreencast(callback: (frame: ScreencastFrame) => void, options?: ScreencastOptions): Promise<void>;
533
- /**
534
- * Stop screencast
535
- */
536
- stopScreencast(): Promise<void>;
537
- /**
538
- * Check if profiling is currently active
539
- */
540
- isProfilingActive(): boolean;
541
- /**
542
- * Start CDP profiling (Tracing)
543
- */
544
- startProfiling(options?: {
545
- categories?: string[];
546
- }): Promise<void>;
547
- /**
548
- * Stop CDP profiling and save to file
549
- */
550
- stopProfiling(outputPath: string): Promise<{
551
- path: string;
552
- eventCount: number;
553
- }>;
554
- /**
555
- * Inject a mouse event via CDP
556
- */
557
- injectMouseEvent(params: {
558
- type: 'mousePressed' | 'mouseReleased' | 'mouseMoved' | 'mouseWheel';
559
- x: number;
560
- y: number;
561
- button?: 'left' | 'right' | 'middle' | 'none';
562
- clickCount?: number;
563
- deltaX?: number;
564
- deltaY?: number;
565
- modifiers?: number;
566
- }): Promise<void>;
567
- /**
568
- * Inject a keyboard event via CDP
569
- */
570
- injectKeyboardEvent(params: {
571
- type: 'keyDown' | 'keyUp' | 'char';
572
- key?: string;
573
- code?: string;
574
- text?: string;
575
- modifiers?: number;
576
- }): Promise<void>;
577
- /**
578
- * Inject touch event via CDP (for mobile emulation)
579
- */
580
- injectTouchEvent(params: {
581
- type: 'touchStart' | 'touchEnd' | 'touchMove' | 'touchCancel';
582
- touchPoints: Array<{
583
- x: number;
584
- y: number;
585
- id?: number;
586
- }>;
587
- modifiers?: number;
588
- }): Promise<void>;
589
- /**
590
- * Check if video recording is currently active
591
- */
592
- isRecording(): boolean;
593
- /**
594
- * Start recording to a video file using Playwright's native video recording.
595
- * Creates a fresh browser context with video recording enabled.
596
- * Automatically captures current URL and transfers cookies/storage if no URL provided.
597
- *
598
- * @param outputPath - Path to the output video file (will be .webm)
599
- * @param url - Optional URL to navigate to (defaults to current page URL)
600
- */
601
- startRecording(outputPath: string, url?: string): Promise<void>;
602
- /**
603
- * Stop recording and save the video file
604
- * @returns Recording result with path
605
- */
606
- stopRecording(): Promise<{
607
- path: string;
608
- frames: number;
609
- error?: string;
610
- }>;
611
- /**
612
- * Restart recording - stops current recording (if any) and starts a new one.
613
- * Convenience method that combines stopRecording and startRecording.
614
- *
615
- * @param outputPath - Path to the output video file (must be .webm)
616
- * @param url - Optional URL to navigate to (defaults to current page URL)
617
- * @returns Result from stopping the previous recording (if any)
618
- */
619
- restartRecording(outputPath: string, url?: string): Promise<{
620
- previousPath?: string;
621
- stopped: boolean;
622
- }>;
623
- /**
624
- * Close the browser and clean up
625
- */
626
- close(): Promise<void>;
627
- }
628
- export {};
629
- //# sourceMappingURL=browser.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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"}