UXP Toolkit
    Preparing search index...

    Interface CdpPoolOptions

    Options for the CDP pool.

    interface CdpPoolOptions {
        cdp:
            | string
            | (() => Promise<string>)
            | (() => Promise<{ teardown: () => Promise<void>; url: string }>);
        connectionTimeout?: number;
        debug?: boolean;
        embedSourcemap?: boolean;
        enableErrorSourcemapping?: boolean;
        esbuildOptions?: PoolEsbuildOptions;
        executionContextOrSession?: (
            cdp: Client,
        ) => Promise<ExecutionContextOrSession>;
        hotkeys?: {
            enabled?: boolean;
            openDevtools?: (connection: CdpConnection) => Promise<void>;
        };
        reuseConnection?: boolean;
        rpcTimeout?: number;
        runBeforeTests?: (connection: CdpConnection) => Promise<void>;
        showBundledStackTrace?: boolean;
    }

    Hierarchy

    • BaseCdpPoolOptions
      • CdpPoolOptions
    Index

    Properties

    cdp connectionTimeout? debug? embedSourcemap? enableErrorSourcemapping? esbuildOptions? executionContextOrSession? hotkeys? reuseConnection? rpcTimeout? runBeforeTests? showBundledStackTrace?

    Properties

    cdp:
        | string
        | (() => Promise<string>)
        | (() => Promise<{ teardown: () => Promise<void>; url: string }>)

    WebSocket URL for the CDP connection, or an async function that returns one.

    // Static URL
    cdpUrl: "ws://localhost:9222/devtools/page/ABC123"

    // Dynamic URL (e.g., for Photoshop UXP)
    cdpUrl: async () => await setupDevtoolsUrl(pluginPath, pluginId)
    connectionTimeout?: number

    Timeout in milliseconds for establishing the CDP connection.

    5000
    debug?: boolean

    Enable debug logging.

    false
    embedSourcemap?: boolean

    Whether to embed the sourcemap as the EVAL_SOURCEMAP global variable in the bundled code. This makes it available to code running in the CDP context for its own use.

    false
    enableErrorSourcemapping?: boolean

    Enable error sourcemapping: remaps stack traces, task locations, and error frames from bundled (esbuild output) positions back to original source positions. Also injects //# sourceURL=filepath so V8 attributes eval'd code to the original file.

    true
    esbuildOptions?: PoolEsbuildOptions

    Options for esbuild.

    executionContextOrSession?: (cdp: Client) => Promise<ExecutionContextOrSession>

    Optional function to get the execution context or session id. By default, runs Target.setAutoAttach and waits for target to be attached and uses the target's session id.

    hotkeys?: {
        enabled?: boolean;
        openDevtools?: (connection: CdpConnection) => Promise<void>;
    }

    Enable interactive hotkeys in the terminal.

    Currently supports:

    • d: open the current CDP devtools session in Google Chrome.

    Type Declaration

    • Optionalenabled?: boolean

      Whether to enable the hotkeys.

      true
    • OptionalopenDevtools?: (connection: CdpConnection) => Promise<void>

      Function to open the devtools session (e.g. in Google Chrome).

      openDevtoolsSessionInChrome

    { enabled: true, openDevtools: openDevtoolsSessionInChrome }
    reuseConnection?: boolean

    Whether to reuse the CDP connection between watch-mode reruns. Single-run mode (watch: false, including non-TTY and CI) always disconnects on stop so the Node process can exit.

    It uses signal-exit to disconnect if the process exits while the connection is still cached for watch mode.

    true
    rpcTimeout?: number

    Timeout in milliseconds for RPC calls to the CDP context.

    30000
    runBeforeTests?: (connection: CdpConnection) => Promise<void>

    Optional function to run after the CDP connection is established. Useful for waiting for debugger or something.

    showBundledStackTrace?: boolean

    When true and enableErrorSourcemapping is also true, the original (bundled) stack trace is preserved as error.bundledStack alongside the remapped error.stack. Worker runtime frames are kept in the bundled stack (no frame filtering).

    Useful for debugging sourcemap remapping issues.

    false

    Settings

    Member Visibility

    On This Page

    Properties