github-featured/chromedevtools--chrome-devtools-mcp
2
0
Fork 0
Code Issues Pull Requests Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
main
chromedevtools--chrome-devt…/docs/tool-reference.md
T
Tolgahan Demirbaş 50a16fae69 feat: make pageId required for page-scoped tools by default (#1777) 
Removes `--experimental-page-id-routing` making it the default behavior.
To go back to the previous behavior, pass `--pageIdRouting=false` when
starting the server.

---------

Co-authored-by: Alex Rudenko <alexrudenko@chromium.org>
Co-authored-by: Samiya Caur <samiyac@google.com>
2026-08-24 16:54:06 +00:00

35 KiB
Raw Permalink Blame History

Chrome DevTools MCP Tool Reference

Input automation

click

Description: Clicks on the provided element

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • uid (string) (required): The uid of an element on the page from the page content snapshot
  • dblClick (boolean) (optional): Set to true for double clicks. Default is false.
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

drag

Description: Drag an element onto another element

Parameters:

  • from_uid (string) (required): The uid of the element to drag
  • pageId (number) (required): Targets a specific page by ID.
  • to_uid (string) (required): The uid of the element to drop into
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

fill

Description: Type text into an input, text area or select an option from a <select> element.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • uid (string) (required): The uid of an element on the page from the page content snapshot
  • value (string) (required): The value to fill in. "true" or "false" for checkboxes and toggles, "true" for radio buttons.
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

fill_form

Description: Fill out multiple form elements (inputs, selects, checkboxes, radios) at once. ALWAYS prefer this tool over multiple individual 'fill' or 'click' calls when interacting with forms. It is significantly faster, more reliable, and reduces turn count. Example: Fill username, password, and check "Remember Me" in one call.

Parameters:

  • elements (array) (required): Elements from snapshot to fill out.
  • pageId (number) (required): Targets a specific page by ID.
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

handle_dialog

Description: If a browser dialog was opened, use this command to handle it

Parameters:

  • action (enum: "accept", "dismiss") (required): Whether to dismiss or accept the dialog
  • pageId (number) (required): Targets a specific page by ID.
  • promptText (string) (optional): Optional prompt text to enter into the dialog.

hover

Description: Hover over the provided element

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • uid (string) (required): The uid of an element on the page from the page content snapshot
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

press_key

Description: Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).

Parameters:

  • key (string) (required): A key or a combination (e.g., "Enter", "Control+A", "Control++", "Control+Shift+R"). Modifiers: Control, Shift, Alt, Meta
  • pageId (number) (required): Targets a specific page by ID.
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

type_text

Description: Type text using keyboard into a previously focused input

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • text (string) (required): The text to type
  • submitKey (string) (optional): Optional key to press after typing. E.g., "Enter", "Tab", "Escape"

upload_file

Description: Upload a file through a provided element.

Parameters:

  • filePaths (array) (required): One or more files paths to upload. File paths have to be local to the browser instance (not the MCP).
  • pageId (number) (required): Targets a specific page by ID.
  • uid (string) (required): The uid of the file input element or an element that will open file chooser on the page from the page content snapshot
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

click_at

Description: Clicks at the provided coordinates (requires flag: --experimentalVision=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • x (number) (required): The x coordinate
  • y (number) (required): The y coordinate
  • dblClick (boolean) (optional): Set to true for double clicks. Default is false.
  • includeSnapshot (boolean) (optional): Whether to include a snapshot in the response. Default is false.

Navigation automation

close_page

Description: Closes the page by its index. The last open page cannot be closed.

Parameters:

  • pageId (number) (required): The ID of the page to close. Call list_pages to list pages.

list_pages

Description: Get a list of pages open in the browser.

Parameters: None

navigate_page

Description: Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • handleBeforeUnload (enum: "accept", "dismiss") (optional): Whether to auto accept or beforeunload dialogs triggered by this navigation. Default is accept.
  • ignoreCache (boolean) (optional): Whether to ignore cache on reload.
  • initScript (string) (optional): A JavaScript script to be executed on each new document before any other scripts for the next navigation.
  • timeout (integer) (optional): Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
  • type (enum: "url", "back", "forward", "reload") (optional): Navigate the page by URL, back or forward in history, or reload.
  • url (string) (optional): Target URL (only type=url)

new_page

Description: Open a new tab and load a URL. Use project URL if not specified otherwise.

Parameters:

  • url (string) (required): URL to load in a new page.
  • background (boolean) (optional): Whether to open the page in the background without bringing it to the front. Default is false (foreground).
  • isolatedContext (string) (optional): If specified, the page is created in an isolated browser context with the given name. Pages in the same browser context share cookies and storage. Pages in different browser contexts are fully isolated.
  • timeout (integer) (optional): Maximum wait time in milliseconds. If set to 0, the default timeout will be used.

select_page

Description: Select a page as a context for future tool calls.

Parameters:

  • pageId (number) (required): The ID of the page to select. Call list_pages to get available pages.
  • bringToFront (boolean) (optional): Whether to focus the page and bring it to the top.

wait_for

Description: Wait for the specified text to appear on the selected page.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • text (array) (required): Non-empty list of texts. Resolves when any value appears on the page.
  • timeout (integer) (optional): Maximum wait time in milliseconds. If set to 0, the default timeout will be used.

Emulation

emulate

Description: Emulates various features on the target page.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • colorScheme (enum: "dark", "light", "auto") (optional): Emulate the dark or the light mode. Set to "auto" to reset to the default.
  • cpuThrottlingRate (number) (optional): Represents the CPU slowdown factor. Omit or set the rate to 1 to disable throttling
  • extraHttpHeaders (string) (optional): Extra HTTP headers as a JSON string object, e.g. {"X-Custom": "value", "Authorization": "Bearer token"}. Headers are included into every HTTP request originating from the page and persist across navigations until cleared. Pass an empty string to clear all extra headers.
  • geolocation (string) (optional): Geolocation (&lt;latitude&gt;,&lt;longitude&gt;) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.
  • networkConditions (enum: "Offline", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") (optional): Throttle network. Omit to disable throttling.
  • userAgent (string) (optional): User agent to emulate. Set to empty string to clear the user agent override.
  • viewport (string) (optional): Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.

resize_page

Description: Resizes the page's window so that the page has specified dimension

Parameters:

  • height (number) (required): Page height
  • pageId (number) (required): Targets a specific page by ID.
  • width (number) (required): Page width

Performance

performance_analyze_insight

Description: Provides more detailed information on a specific Performance Insight of an insight set that was highlighted in the results of a trace recording.

Parameters:

  • insightName (string) (required): The name of the Insight you want more information on. For example: "DocumentLatency" or "LCPBreakdown"
  • insightSetId (string) (required): The id for the specific insight set. Only use the ids given in the "Available insight sets" list.
  • pageId (number) (required): Targets a specific page by ID.

performance_start_trace

Description: Start a performance trace on the target webpage. Use to find frontend performance issues, Core Web Vitals (LCP, INP, CLS), and improve page load speed.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • autoStop (boolean) (optional): Determines if the trace recording should be automatically stopped.
  • filePath (string) (optional): The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed).
  • reload (boolean) (optional): Determines if, once tracing has started, the target page should be automatically reloaded. Navigate the page to the right URL using the navigate_page tool BEFORE starting the trace if reload or autoStop is set to true.

performance_stop_trace

Description: Stop the active performance trace recording on the target webpage.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • filePath (string) (optional): The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed).

Network

get_network_request

Description: Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • reqid (number) (optional): The reqid of the network request. If omitted returns the currently selected request in the DevTools Network panel.
  • requestFilePath (string) (optional): The absolute or relative path to a .network-request file to save the request body to. If omitted, the body is returned inline.
  • responseFilePath (string) (optional): The absolute or relative path to a .network-response file to save the response body to. If omitted, the body is returned inline.

list_network_requests

Description: Lists the most recent requests for the target page since the last navigation.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • includePreservedRequests (boolean) (optional): Set to true to return the preserved requests over the last 3 navigations.
  • pageIdx (integer) (optional): Page number to return (0-based). When omitted, returns the first page.
  • pageSize (integer) (optional): Maximum number of requests to return. When omitted, returns all requests.
  • resourceTypes (array) (optional): Filter requests to only return requests of the specified resource types. When omitted or empty, returns all requests.

Debugging

evaluate_script

Description: Evaluate a JavaScript function inside the target page. Returns the response as JSON, so returned values have to be JSON-serializable.

Parameters:

  • function (string) (required): A JavaScript function declaration to be executed by the tool in the target page. Example without arguments: () => document.title or async () => await fetch("example.com"). Example with arguments: (el) => el.innerText

  • pageId (number) (required): Targets a specific page by ID.

  • args (array) (optional): An optional list of arguments to pass to the function.

  • dialogAction (string) (optional): Handle dialogs while execution. "accept", "dismiss", or string for response of window.prompt. Defaults to accept.

  • filePath (string) (optional): The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline.

  • waitForStableDom (boolean) (optional): Whether to wait for the DOM to settle. Pass false if the script only reads data. Defaults to true.

get_console_message

Description: Gets a console message by its ID. You can get all messages by calling list_console_messages.

Parameters:

  • msgid (number) (required): The msgid of a console message on the page from the listed console messages
  • pageId (number) (required): Targets a specific page by ID.

lighthouse_audit

Description: Get Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run performance_start_trace

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • device (enum: "desktop", "mobile") (optional): Device to emulate.
  • mode (enum: "navigation", "snapshot") (optional): "navigation" reloads & audits. "snapshot" analyzes current state.
  • outputDirPath (string) (optional): Directory for reports. If omitted, uses temporary files.

list_console_messages

Description: List all console messages for the target page since the last navigation.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • includePreservedMessages (boolean) (optional): Set to true to return the preserved messages over the last 3 navigations.
  • includeStackTraces (boolean) (optional): Set to true to include the stack trace for each message when available. Increases the response size.
  • pageIdx (integer) (optional): Page number to return (0-based). When omitted, returns the first page.
  • pageSize (integer) (optional): Maximum number of messages to return. When omitted, returns all messages.
  • serviceWorkerId (string) (optional): Filter messages to only return messages of the specified service worker.
  • types (array) (optional): Filter messages to only return messages of the specified resource types. When omitted or empty, returns all messages.

take_screenshot

Description: Take a screenshot of the page or element.

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • filePath (string) (optional): The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response.
  • format (enum: "png", "jpeg", "webp") (optional): Type of format to save the screenshot as. Default is "png"
  • fullPage (boolean) (optional): If set to true takes a screenshot of the full page instead of the currently visible viewport. Incompatible with uid.
  • quality (number) (optional): Compression quality for JPEG and WebP formats (0-100). Higher values mean better quality but larger file sizes. Ignored for PNG format.
  • uid (string) (optional): The uid of an element on the page from the page content snapshot. If omitted, takes a page screenshot.

take_snapshot

Description: Take a text snapshot of the target page based on the a11y tree. The snapshot lists page elements along with a unique identifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot. The snapshot indicates the element selected in the DevTools Elements panel (if any).

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • filePath (string) (optional): The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response.
  • verbose (boolean) (optional): Whether to include all possible information available in the full a11y tree. Default is false.

screencast_start

Description: Starts recording a screencast (video) of the target page in specified format. (requires flag: --experimentalScreencast=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • filePath (string) (optional): Output file path (.webm,.mp4 are supported). Uses mkdtemp to generate a unique path if not provided.

screencast_stop

Description: Stops the active screencast recording on the target page. (requires flag: --experimentalScreencast=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.

Memory

take_heapsnapshot

Description: Capture a heap snapshot of the target page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to save the heapsnapshot to.
  • pageId (number) (required): Targets a specific page by ID.

close_heapsnapshot

Description: Closes a previously loaded memory heapsnapshot, freeing its memory. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to the .heapsnapshot file to close.

compare_heapsnapshots

Description: Loads two memory heapsnapshots and returns the comparison. If classIndex is provided, returns detailed diff for that class, otherwise returns summary diff. (requires flag: --memoryDebugging=true)

Parameters:

  • baseFilePath (string) (required): A path to the base .heapsnapshot file (earlier snapshot).
  • currentFilePath (string) (required): A path to the current .heapsnapshot file (later snapshot).
  • classIndex (number) (optional): Optional 0-based index of the class in the summary list to filter results, showing individual objects.

get_heapsnapshot_class_nodes

Description: Loads a memory heapsnapshot and returns instances of a specific class with their IDs. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • id (number) (required): The ID for the class, obtained from details.
  • filterName (enum: "objectsRetainedByDetachedDomNodes", "objectsRetainedByConsole", "objectsRetainedByEventHandlers", "objectsRetainedByContexts", "sharedNativeContext", "noNativeContext", "attributedToSpecificNativeContext") (optional): An optional filter to apply to the nodes.
  • objectId (number) (optional): The object ID (nodeId) of the specific native context to filter by when filterName is attributedToSpecificNativeContext.
  • pageIdx (number) (optional): The page index for pagination.
  • pageSize (number) (optional): The page size for pagination.

get_heapsnapshot_details

Description: Loads a memory heapsnapshot and returns all available information including statistics, static data, and aggregated node information. Supports pagination for aggregates. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • filterName (enum: "objectsRetainedByDetachedDomNodes", "objectsRetainedByConsole", "objectsRetainedByEventHandlers", "objectsRetainedByContexts", "sharedNativeContext", "noNativeContext", "attributedToSpecificNativeContext") (optional): An optional filter to apply to the aggregates.
  • objectId (number) (optional): The object ID (nodeId) of the specific native context to filter by when filterName is attributedToSpecificNativeContext.
  • pageIdx (number) (optional): The page index for pagination of aggregates.
  • pageSize (number) (optional): The page size for pagination of aggregates.

get_heapsnapshot_dominators

Description: Loads a memory heapsnapshot and returns the dominator chain for a specific node ID. This helps to identify which objects are keeping the target node alive. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • nodeId (number) (required): The node ID to get the dominator chain for.

get_heapsnapshot_duplicate_strings

Description: Loads a memory heapsnapshot and returns duplicate strings grouped by their value. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • pageIdx (number) (optional): The page index for pagination.
  • pageSize (number) (optional): The page size for pagination.

get_heapsnapshot_edges

Description: Loads a memory heapsnapshot and returns outgoing edges (references) for a specific node ID. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • nodeId (number) (required): The node ID to get outgoing edges for.
  • excludePrimitives (boolean) (optional): Whether to exclude primitive target nodes. Default is true.
  • pageIdx (number) (optional): The page index for pagination.
  • pageSize (number) (optional): The page size for pagination.
  • retainedSize (string) (optional): Inclusive retained size range (e.g. "1MB-2MB", "-1MB", or "1MB-") for target nodes. A single value is treated as a minimum. Currently, only the lower bound is applied.
  • sortBy (enum: "retainedSize", "selfSize", "name") (optional): Sort order for edges. Default is retainedSize.

get_heapsnapshot_object_details

Description: Loads a memory heapsnapshot and returns detailed information about a specific object by its node ID, including size, type, distance, and DOM detachedness. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • nodeId (number) (required): The node ID to get object details for.

get_heapsnapshot_retainers

Description: Loads a memory heapsnapshot and returns retainers for a specific node ID. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • nodeId (number) (required): The node ID to get retainers for.
  • pageIdx (number) (optional): The page index for pagination.
  • pageSize (number) (optional): The page size for pagination.

get_heapsnapshot_retaining_paths

Description: Loads a memory heapsnapshot and returns retaining paths for a specific node ID. This helps to understand why a node is not being garbage collected. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • nodeId (number) (required): The node ID to get retaining paths for.
  • maxDepth (number) (optional): The maximum depth to search for retaining paths.
  • maxNodes (number) (optional): The maximum number of nodes to return.
  • maxSiblings (number) (optional): The maximum number of siblings to return.

get_heapsnapshot_summary

Description: Loads a memory heapsnapshot and returns snapshot summary stats, including native contexts and their sizes, and retained by context summary. (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.

query_heapsnapshot_objects

Description: Loads a memory heapsnapshot and queries objects matching specific filters (className, propertyName, nodeType, retainedSize, selfSize, isDetached, sortBy). (requires flag: --memoryDebugging=true)

Parameters:

  • filePath (string) (required): A path to a .heapsnapshot file to read.
  • className (string) (optional): Optional regex or text matching object class name.
  • isDetached (boolean) (optional): Whether to filter for detached DOM nodes.
  • nodeType (string) (optional): Optional V8 node type filter (e.g. object, closure, string, array, code).
  • pageIdx (number) (optional): The page index for pagination.
  • pageSize (number) (optional): The page size for pagination.
  • propertyName (string) (optional): Optional property name filter for outgoing reference edges.
  • retainedSize (string) (optional): Inclusive retained size range (e.g. "1MB-2MB", "-1MB", or "1MB-"). A single value is treated as a minimum.
  • selfSize (string) (optional): Inclusive self size range (e.g. "1MB-2MB", "-1MB", or "1MB-"). A single value is treated as a minimum.
  • sortBy (enum: "retainedSize", "selfSize", "id") (optional): Sort order for results. Default is retainedSize.

Extensions

NOTE: The Extensions category is not active by default. Use the '--categoryExtensions' flag.

install_extension

Description: Installs a Chrome extension from the given path. (requires flag: --categoryExtensions=true)

Parameters:

  • path (string) (required): Absolute path to the unpacked extension folder.

list_extensions

Description: Lists all the Chrome extensions installed in the browser. This includes their name, ID, version, and enabled status. (requires flag: --categoryExtensions=true)

Parameters: None

reload_extension

Description: Reloads an unpacked Chrome extension by its ID. (requires flag: --categoryExtensions=true)

Parameters:

  • id (string) (required): ID of the extension to reload.

trigger_extension_action

Description: Triggers the default action of an extension by its ID. (requires flag: --categoryExtensions=true)

Parameters:

  • id (string) (required): ID of the extension to trigger the action for.

uninstall_extension

Description: Uninstalls a Chrome extension by its ID. (requires flag: --categoryExtensions=true)

Parameters:

  • id (string) (required): ID of the extension to uninstall.

Third-party

NOTE: The Third-party category is not active by default. Use the '--categoryExperimentalThirdParty' flag.

execute_3p_developer_tool

Description: Executes a tool exposed by the page. (requires flag: --categoryExperimentalThirdParty=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • toolName (string) (required): The name of the tool to execute
  • params (string) (optional): The JSON-stringified parameters to pass to the tool

list_3p_developer_tools

Description: Lists all third-party developer tools the page exposes for providing runtime information. Third-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool. Alternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the following command to the script: window.__dtmcp.executeTool(toolName, params) This might be helpful when the third-party developer tools return non-serializable values or when composing third-party developer tools with additional functionality. (requires flag: --categoryExperimentalThirdParty=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.

WebMCP

NOTE: The WebMCP category is not active by default. Use the '--categoryExperimentalWebmcp' flag.

execute_webmcp_tool

Description: Executes a WebMCP tool exposed by the page. (requires flag: --categoryExperimentalWebmcp=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.
  • toolName (string) (required): The name of the WebMCP tool to execute
  • input (string) (optional): The JSON-stringified parameters to pass to the WebMCP tool

list_webmcp_tools

Description: Lists all WebMCP tools the page exposes. (requires flag: --categoryExperimentalWebmcp=true)

Parameters:

  • pageId (number) (required): Targets a specific page by ID.

Progressive Web Apps

NOTE: The Progressive Web Apps category is not active by default. Use the '--categoryPwa' flag.

get_os_app_state

Description: Returns the OS integration state (badge count and registered file handlers) for an installed web app, identified by its manifest ID. (requires flag: --categoryPwa=true)

Parameters:

install_pwa

Description: Installs a Progressive Web App (PWA) identified by its manifest ID. This installs through the PWA CDP domain without a user gesture or install dialog. DevTools installs default to browser display mode. (requires flag: --categoryPwa=true)

Parameters:

  • installUrlOrBundleUrl (string) (required): The location of the app or bundle. For a normal site this is the page URL; for an Isolated Web App it can be a file:// or http(s):// signed web bundle.
  • manifestId (string) (required): The manifest ID of the web app: the resolved id member of its manifest. If id is omitted, it defaults to the resolved start_url (e.g. "https://example.com/"). See https://w3c.github.io/manifest/#id-member.
  • displayMode (enum: "standalone", "browser") (optional): Optional user display mode preference applied after install. "standalone" opens the app in its own window; "browser" opens it as a tab. Installs via the PWA CDP domain default to "browser" because they do not simulate the install dialog, so pass "standalone" to get an app-window experience.

launch_pwa

Description: Launches an installed Progressive Web App using its saved display mode. Optionally opens a specific URL within the same app instead of the default start URL. (requires flag: --categoryPwa=true)

Parameters:

  • manifestId (string) (required): The manifest ID of the web app: the resolved id member of its manifest. If id is omitted, it defaults to the resolved start_url (e.g. "https://example.com/"). See https://w3c.github.io/manifest/#id-member.
  • url (string) (optional): Optional URL within the app to open instead of the default start URL.

uninstall_pwa

Description: Uninstalls a Progressive Web App identified by its manifest ID and closes any open app windows. (requires flag: --categoryPwa=true)

Parameters:

Reference in New Issue View Git Blame Copy Permalink