browserclaw 0.10.4 → 0.10.5

package/dist/index.d.cts

@@ -77,7 +77,6 @@ type BatchAction = {
     url?: string;
     loadState?: 'load' | 'domcontentloaded' | 'networkidle';
     fn?: string;
-    arg?: unknown;
     targetId?: string;
     timeoutMs?: number;
 } | {
@@ -185,8 +184,6 @@ interface LaunchOptions {
     profileColor?: string;
     /** Additional Chrome command-line arguments (e.g. `['--start-maximized']`). */
     chromeArgs?: string[];
-    /** Ignore HTTPS certificate errors (e.g. expired local dev certs). Default: `false` */
-    ignoreHTTPSErrors?: boolean;
     /**
      * SSRF policy controlling which URLs navigation is allowed to reach.
      * Defaults to trusted-network mode (private/internal addresses allowed).
@@ -252,10 +249,6 @@ interface RoleRefInfo {
     name?: string;
     /** Disambiguation index when multiple elements share the same role + name */
     nth?: number;
-    /** Whether the element is disabled (from `[disabled]` or `aria-disabled`) */
-    disabled?: boolean;
-    /** Whether a checkbox/radio/switch is checked */
-    checked?: boolean | 'mixed';
 }
 /** Map of ref IDs (e.g. `'e1'`, `'e2'`) to their element information. */
 type RoleRefs = Record<string, RoleRefInfo>;
@@ -382,8 +375,6 @@ interface ClickOptions {
     delayMs?: number;
     /** Timeout in milliseconds. Default: `8000` */
     timeoutMs?: number;
-    /** Force click even if element is hidden or covered. Dispatches the event regardless of visibility. */
-    force?: boolean;
 }
 /** Options for type actions. */
 interface TypeOptions {
@@ -411,10 +402,8 @@ interface WaitOptions {
     url?: string;
     /** Wait for a specific page load state */
     loadState?: 'load' | 'domcontentloaded' | 'networkidle';
-    /** Wait until a JavaScript function returns truthy (evaluated in browser context). Accepts a string or a serializable function. */
-    fn?: string | ((arg?: unknown) => unknown);
-    /** Serializable argument passed to `fn` in the browser context. Use an array or object to pass multiple values. */
-    arg?: unknown;
+    /** Wait until a JavaScript function returns truthy (evaluated in browser context) */
+    fn?: string;
     /** Timeout for each condition in milliseconds. Default: `20000` */
     timeoutMs?: number;
 }
@@ -543,23 +532,6 @@ interface DialogEvent {
 }
 /** Callback for persistent dialog handling. */
 type DialogHandler = (event: DialogEvent) => void | Promise<void>;
-/** Result of waiting for a network request to complete. */
-interface RequestResult {
-    /** The final request URL */
-    url: string;
-    /** HTTP method (e.g. `'GET'`, `'POST'`) */
-    method: string;
-    /** Request body (for POST/PUT/PATCH requests) */
-    postData?: string;
-    /** HTTP response status code */
-    status: number;
-    /** Whether the response status was 2xx */
-    ok: boolean;
-    /** Response body text */
-    responseBody?: string;
-    /** Whether the response body was truncated due to maxChars */
-    truncated?: boolean;
-}
 /** Result of intercepting a response body. */
 interface ResponseBodyResult {
     /** The response URL */
@@ -745,26 +717,6 @@ declare class CrawlPage {
         clickCount?: number;
         delayMs?: number;
     }): Promise<void>;
-    /**
-     * Press and hold at page coordinates using raw CDP events.
-     *
-     * Bypasses Playwright's automation layer by dispatching CDP
-     * `Input.dispatchMouseEvent` directly — useful for anti-bot challenges
-     * that detect automated clicks.
-     *
-     * @param x - X coordinate in CSS pixels
-     * @param y - Y coordinate in CSS pixels
-     * @param opts - Options (delay: ms before press, holdMs: hold duration)
-     *
-     * @example
-     * ```ts
-     * await page.pressAndHold(400, 300, { delay: 150, holdMs: 5000 });
-     * ```
-     */
-    pressAndHold(x: number, y: number, opts?: {
-        delay?: number;
-        holdMs?: number;
-    }): Promise<void>;
     /**
      * Click an element by its visible text content (no snapshot/ref needed).
      *
@@ -802,7 +754,6 @@ declare class CrawlPage {
      * ```
      */
     clickByRole(role: string, name?: string, opts?: {
-        index?: number;
         button?: 'left' | 'right' | 'middle';
         modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
         timeoutMs?: number;
@@ -1185,30 +1136,6 @@ declare class CrawlPage {
         timeoutMs?: number;
         maxChars?: number;
     }): Promise<ResponseBodyResult>;
-    /**
-     * Wait for a network request matching a URL pattern and return request + response details.
-     *
-     * Unlike `networkRequests()` which only captures metadata, this method captures
-     * the full request body (POST data) and response body.
-     *
-     * @param url - URL string or pattern to match (supports `*` wildcards and substring matching)
-     * @param opts - Options (method filter, timeoutMs, maxChars for response body)
-     * @returns Request method, postData, response status, and response body
-     *
-     * @example
-     * ```ts
-     * const reqPromise = page.waitForRequest('/api/submit', { method: 'POST' });
-     * await page.click('e5'); // submit a form
-     * const req = await reqPromise;
-     * console.log(req.postData); // form body
-     * console.log(req.status, req.responseBody); // response
-     * ```
-     */
-    waitForRequest(url: string, opts?: {
-        method?: string;
-        timeoutMs?: number;
-        maxChars?: number;
-    }): Promise<RequestResult>;
     /**
      * Get console messages captured from the page.
      *
@@ -1579,26 +1506,6 @@ declare class BrowserClaw {
      * @returns Array of tab information objects
      */
     tabs(): Promise<BrowserTab[]>;
-    /**
-     * Wait for a tab matching the given criteria and return a page handle.
-     *
-     * Polls open tabs until one matches, then focuses it and returns a CrawlPage.
-     *
-     * @param opts - Match criteria (urlContains, titleContains) and timeout
-     * @returns A CrawlPage for the matched tab
-     *
-     * @example
-     * ```ts
-     * await page.click('e5'); // opens a new tab
-     * const appPage = await browser.waitForTab({ urlContains: 'app-web' });
-     * const { snapshot } = await appPage.snapshot();
-     * ```
-     */
-    waitForTab(opts: {
-        urlContains?: string;
-        titleContains?: string;
-        timeoutMs?: number;
-    }): Promise<CrawlPage>;
     /**
      * Bring a tab to the foreground.
      *
@@ -1810,15 +1717,6 @@ declare function getRestoredPageForTarget(opts: {
     targetId?: string;
 }): Promise<Page>;
 
-declare function pressAndHoldViaCdp(opts: {
-    cdpUrl: string;
-    targetId?: string;
-    x: number;
-    y: number;
-    delay?: number;
-    holdMs?: number;
-}): Promise<void>;
-
 /**
  * Comprehensive browser stealth evasions.
  *
@@ -1857,4 +1755,4 @@ declare function waitForChallengeViaPlaywright(opts: {
     pollMs?: number;
 }): Promise<ChallengeWaitResult>;
 
-export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type RequestResult, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, pressAndHoldViaCdp, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };
+export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };

package/dist/index.d.ts

@@ -77,7 +77,6 @@ type BatchAction = {
     url?: string;
     loadState?: 'load' | 'domcontentloaded' | 'networkidle';
     fn?: string;
-    arg?: unknown;
     targetId?: string;
     timeoutMs?: number;
 } | {
@@ -185,8 +184,6 @@ interface LaunchOptions {
     profileColor?: string;
     /** Additional Chrome command-line arguments (e.g. `['--start-maximized']`). */
     chromeArgs?: string[];
-    /** Ignore HTTPS certificate errors (e.g. expired local dev certs). Default: `false` */
-    ignoreHTTPSErrors?: boolean;
     /**
      * SSRF policy controlling which URLs navigation is allowed to reach.
      * Defaults to trusted-network mode (private/internal addresses allowed).
@@ -252,10 +249,6 @@ interface RoleRefInfo {
     name?: string;
     /** Disambiguation index when multiple elements share the same role + name */
     nth?: number;
-    /** Whether the element is disabled (from `[disabled]` or `aria-disabled`) */
-    disabled?: boolean;
-    /** Whether a checkbox/radio/switch is checked */
-    checked?: boolean | 'mixed';
 }
 /** Map of ref IDs (e.g. `'e1'`, `'e2'`) to their element information. */
 type RoleRefs = Record<string, RoleRefInfo>;
@@ -382,8 +375,6 @@ interface ClickOptions {
     delayMs?: number;
     /** Timeout in milliseconds. Default: `8000` */
     timeoutMs?: number;
-    /** Force click even if element is hidden or covered. Dispatches the event regardless of visibility. */
-    force?: boolean;
 }
 /** Options for type actions. */
 interface TypeOptions {
@@ -411,10 +402,8 @@ interface WaitOptions {
     url?: string;
     /** Wait for a specific page load state */
     loadState?: 'load' | 'domcontentloaded' | 'networkidle';
-    /** Wait until a JavaScript function returns truthy (evaluated in browser context). Accepts a string or a serializable function. */
-    fn?: string | ((arg?: unknown) => unknown);
-    /** Serializable argument passed to `fn` in the browser context. Use an array or object to pass multiple values. */
-    arg?: unknown;
+    /** Wait until a JavaScript function returns truthy (evaluated in browser context) */
+    fn?: string;
     /** Timeout for each condition in milliseconds. Default: `20000` */
     timeoutMs?: number;
 }
@@ -543,23 +532,6 @@ interface DialogEvent {
 }
 /** Callback for persistent dialog handling. */
 type DialogHandler = (event: DialogEvent) => void | Promise<void>;
-/** Result of waiting for a network request to complete. */
-interface RequestResult {
-    /** The final request URL */
-    url: string;
-    /** HTTP method (e.g. `'GET'`, `'POST'`) */
-    method: string;
-    /** Request body (for POST/PUT/PATCH requests) */
-    postData?: string;
-    /** HTTP response status code */
-    status: number;
-    /** Whether the response status was 2xx */
-    ok: boolean;
-    /** Response body text */
-    responseBody?: string;
-    /** Whether the response body was truncated due to maxChars */
-    truncated?: boolean;
-}
 /** Result of intercepting a response body. */
 interface ResponseBodyResult {
     /** The response URL */
@@ -745,26 +717,6 @@ declare class CrawlPage {
         clickCount?: number;
         delayMs?: number;
     }): Promise<void>;
-    /**
-     * Press and hold at page coordinates using raw CDP events.
-     *
-     * Bypasses Playwright's automation layer by dispatching CDP
-     * `Input.dispatchMouseEvent` directly — useful for anti-bot challenges
-     * that detect automated clicks.
-     *
-     * @param x - X coordinate in CSS pixels
-     * @param y - Y coordinate in CSS pixels
-     * @param opts - Options (delay: ms before press, holdMs: hold duration)
-     *
-     * @example
-     * ```ts
-     * await page.pressAndHold(400, 300, { delay: 150, holdMs: 5000 });
-     * ```
-     */
-    pressAndHold(x: number, y: number, opts?: {
-        delay?: number;
-        holdMs?: number;
-    }): Promise<void>;
     /**
      * Click an element by its visible text content (no snapshot/ref needed).
      *
@@ -802,7 +754,6 @@ declare class CrawlPage {
      * ```
      */
     clickByRole(role: string, name?: string, opts?: {
-        index?: number;
         button?: 'left' | 'right' | 'middle';
         modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
         timeoutMs?: number;
@@ -1185,30 +1136,6 @@ declare class CrawlPage {
         timeoutMs?: number;
         maxChars?: number;
     }): Promise<ResponseBodyResult>;
-    /**
-     * Wait for a network request matching a URL pattern and return request + response details.
-     *
-     * Unlike `networkRequests()` which only captures metadata, this method captures
-     * the full request body (POST data) and response body.
-     *
-     * @param url - URL string or pattern to match (supports `*` wildcards and substring matching)
-     * @param opts - Options (method filter, timeoutMs, maxChars for response body)
-     * @returns Request method, postData, response status, and response body
-     *
-     * @example
-     * ```ts
-     * const reqPromise = page.waitForRequest('/api/submit', { method: 'POST' });
-     * await page.click('e5'); // submit a form
-     * const req = await reqPromise;
-     * console.log(req.postData); // form body
-     * console.log(req.status, req.responseBody); // response
-     * ```
-     */
-    waitForRequest(url: string, opts?: {
-        method?: string;
-        timeoutMs?: number;
-        maxChars?: number;
-    }): Promise<RequestResult>;
     /**
      * Get console messages captured from the page.
      *
@@ -1579,26 +1506,6 @@ declare class BrowserClaw {
      * @returns Array of tab information objects
      */
     tabs(): Promise<BrowserTab[]>;
-    /**
-     * Wait for a tab matching the given criteria and return a page handle.
-     *
-     * Polls open tabs until one matches, then focuses it and returns a CrawlPage.
-     *
-     * @param opts - Match criteria (urlContains, titleContains) and timeout
-     * @returns A CrawlPage for the matched tab
-     *
-     * @example
-     * ```ts
-     * await page.click('e5'); // opens a new tab
-     * const appPage = await browser.waitForTab({ urlContains: 'app-web' });
-     * const { snapshot } = await appPage.snapshot();
-     * ```
-     */
-    waitForTab(opts: {
-        urlContains?: string;
-        titleContains?: string;
-        timeoutMs?: number;
-    }): Promise<CrawlPage>;
     /**
      * Bring a tab to the foreground.
      *
@@ -1810,15 +1717,6 @@ declare function getRestoredPageForTarget(opts: {
     targetId?: string;
 }): Promise<Page>;
 
-declare function pressAndHoldViaCdp(opts: {
-    cdpUrl: string;
-    targetId?: string;
-    x: number;
-    y: number;
-    delay?: number;
-    holdMs?: number;
-}): Promise<void>;
-
 /**
  * Comprehensive browser stealth evasions.
  *
@@ -1857,4 +1755,4 @@ declare function waitForChallengeViaPlaywright(opts: {
     pollMs?: number;
 }): Promise<ChallengeWaitResult>;
 
-export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type RequestResult, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, pressAndHoldViaCdp, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };
+export { type AriaNode, type AriaSnapshotResult, type BatchAction, type BatchActionResult, BrowserClaw, type BrowserNavigationPolicyOptions, type BrowserNavigationRequestLike, type BrowserTab, BrowserTabNotFoundError, type ChallengeInfo, type ChallengeKind, type ChallengeWaitResult, type ChromeExecutable, type ChromeKind, type ClickOptions, type ColorScheme, type ConnectOptions, type ConsoleMessage, type ContextState, type CookieData, CrawlPage, type DialogEvent, type DialogHandler, type DialogOptions, type DownloadResult, type FormField, type FrameEvalResult, type GeolocationOptions, type HttpCredentials, InvalidBrowserNavigationUrlError, type LaunchOptions, type LookupFn, type NetworkRequest, type PageError, type PinnedHostname, type ResponseBodyResult, type RoleRefInfo, type RoleRefs, STEALTH_SCRIPT, type ScreenshotOptions, type SnapshotOptions, type SnapshotResult, type SnapshotStats, type SsrfPolicy, type StorageKind, type TraceStartOptions, type TypeOptions, type UntrustedContentMeta, type WaitOptions, assertBrowserNavigationAllowed, assertBrowserNavigationRedirectChainAllowed, assertBrowserNavigationResultAllowed, assertSafeUploadPaths, batchViaPlaywright, createPinnedLookup, detectChallengeViaPlaywright, ensureContextState, executeSingleAction, forceDisconnectPlaywrightForTarget, getChromeWebSocketUrl, getRestoredPageForTarget, isChromeCdpReady, isChromeReachable, normalizeCdpHttpBaseForJsonEndpoints, parseRoleRef, requireRef, requireRefOrSelector, requiresInspectableBrowserNavigationRedirects, resolveBoundedDelayMs, resolveInteractionTimeoutMs, resolvePageByTargetIdOrThrow, resolvePinnedHostnameWithPolicy, resolveStrictExistingUploadPaths, sanitizeUntrustedFileName, setDialogHandler, waitForChallengeViaPlaywright, withBrowserNavigationPolicy, withPageScopedCdpClient, withPlaywrightPageCdpSession, writeViaSiblingTempPath };