豆豆友情提示:这是一个非官方 GitHub 代理镜像,主要用于网络测试或访问加速。请勿在此进行登录、注册或处理任何敏感信息。进行这些操作请务必访问官方网站 github.com。 Raw 内容也通过此代理提供。
Skip to content

Latest commit

 

History

History
321 lines (187 loc) · 8.31 KB

File metadata and controls

321 lines (187 loc) · 8.31 KB

Chrome DevTools MCP Tool Reference

Input automation

click

Description: Clicks on the provided element

Parameters:

  • dblClick (boolean) (optional): Set to true for double clicks. Default is false.
  • uid (string) (required): The uid of an element on the page from the page content snapshot

drag

Description: Drag an element onto another element

Parameters:

  • from_uid (string) (required): The uid of the element to drag
  • to_uid (string) (required): The uid of the element to drop into

fill

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

Parameters:

  • uid (string) (required): The uid of an element on the page from the page content snapshot
  • value (string) (required): The value to fill in

fill_form

Description: Fill out multiple form elements at once

Parameters:

  • elements (array) (required): Elements from snapshot to fill out.

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
  • promptText (string) (optional): Optional prompt text to enter into the dialog.

hover

Description: Hover over the provided element

Parameters:

  • uid (string) (required): The uid of an element on the page from the page content snapshot

upload_file

Description: Upload a file through a provided element.

Parameters:

  • filePath (string) (required): The local path of the file to upload
  • 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

Navigation automation

close_page

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

Parameters:

  • pageIdx (number) (required): The index 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: Navigates the currently selected page to a URL.

Parameters:

  • url (string) (required): URL to navigate the page to

navigate_page_history

Description: Navigates the currently selected page.

Parameters:

  • navigate (enum: "back", "forward") (required): Whether to navigate back or navigate forward in the selected pages history

new_page

Description: Creates a new page

Parameters:

  • url (string) (required): URL to load in a new page.

select_page

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

Parameters:

  • pageIdx (number) (required): The index of the page to select. Call list_pages to list pages.

wait_for

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

Parameters:

  • text (string) (required): Text to appear on the page

Emulation

emulate_cpu

Description: Emulates CPU throttling by slowing down the selected page's execution.

Parameters:

  • throttlingRate (number) (required): The CPU throttling rate representing the slowdown factor 1-20x. Set the rate to 1 to disable throttling

emulate_network

Description: Emulates network conditions such as throttling on the selected page.

Parameters:

  • throttlingOption (enum: "No emulation", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") (required): The network throttling option to emulate. Available throttling options are: No emulation, Slow 3G, Fast 3G, Slow 4G, Fast 4G. Set to "No emulation" to disable.

resize_page

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

Parameters:

  • height (number) (required): Page height
  • width (number) (required): Page width

Performance

performance_analyze_insight

Description: Provides more detailed information on a specific Performance Insight that was highlighed 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"

performance_start_trace

Description: Starts a performance trace recording on the selected page.

Parameters:

  • autoStop (boolean) (required): Determines if the trace recording should be automatically stopped.
  • reload (boolean) (required): Determines if, once tracing has started, the page should be automatically reloaded

performance_stop_trace

Description: Stops the active performance trace recording on the selected page.

Parameters: None


Network

get_network_request

Description: Gets a network request by URL. You can get all requests by calling list_network_requests.

Parameters:

  • url (string) (required): The URL of the request.

list_network_requests

Description: List all requests for the currently selected page

Parameters:

  • 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.

Debugging

evaluate_script

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

Parameters:

  • args (array) (optional): An optional list of arguments to pass to the function.
  • function (string) (required): A JavaScript function to run in the currently selected page. Example without arguments: () => { return document.title } or async () => { return await fetch("example.com") }. Example with arguments: (el) => { return el.innerText; }

list_console_messages

Description: List all console messages for the currently selected page

Parameters: None


take_screenshot

Description: Take a screenshot of the page or element.

Parameters:

  • format (enum: "png", "jpeg") (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.
  • uid (string) (optional): The uid of an element on the page from the page content snapshot. If omitted takes a pages screenshot.

take_snapshot

Description: Take a text snapshot of the currently selected page. The snapshot lists page elements along with a unique identifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot.

Parameters: None