Playwright MCP

🚀 Playwright: A Comprehensive Automation Tool

Playwright is a powerful tool that simplifies the workflow of cross - browser testing. It offers a one - stop automation solution, supporting multiple browsers and providing a rich set of features.

🚀 Quick Start

Launching Browsers and Running Commands with Playwright CLI

To launch a browser and run commands on it, use the playwright CLI:

# Run the "whoAmI" command on Chrome
playwright chrome -- eval 'await page.evaluate(() => { return window.whoAmI; })'

# Run ".getTitle" on Firefox
playwright firefox -- get-title

# Run "getScreenInfo" on WebKit
playwright webkit -- get-screen-info

✨ Features

Supported Browsers and Their Commands

Playwright currently supports the following browsers:

• chromium

  • --headless: Launch in headless mode (i.e., without a graphical interface).
  • --no - sandbox: Disable the sandbox mode.

• firefox

  • -p <profile>: Specify the path to the Firefox profile.

• webkit

  • --remote - debugging: Enable remote debugging.

List of Browser Playgrounds Commands

Basic Operations

• browserSnapshot: Capture an accessibility snapshot of the current page, which is more effective for subsequent operations.
• browserTakeScreenshot: Take a screenshot of the current page. You cannot perform operations based on this screenshot. Use browserSnapshot for operations.

File and Media

• browserFileUpload: Upload files to a specified location.
  • Parameter: paths (array) — The absolute paths of the files to be uploaded, which can be one or more files.
• browserPdfSave: Save the page as a PDF file.
  • Parameter: None.

Navigation

• browserNavigate: Navigate to a specified URL.
  • Parameter: url (string) — The target URL to navigate to.
• browserNavigateBack: Go back to the previous page.
  • Parameter: None.
• browserNavigateForward: Go forward to the next page.
  • Parameter: None.

Keyboard Operations

• browserPressKey: Press a key on the keyboard.
  • Parameter: key (string) — The name of the key to press or the generated character, such as ArrowLeft or a.

Console

• browserConsoleMessages: Return all console messages.
  • Parameter: None.

Waiting and Closing

• browserWait: Wait for a specified time (in seconds).
  • Parameter: time (number) — The duration to wait, with a maximum limit of 10 seconds.
• browserClose: Close the current page.
  • Parameter: None.

Browser Installation

• browserInstall: Install the browser specified in the configuration. Call this command if you encounter an error indicating that the browser is not installed.
  • Parameter: None.

🔧 Technical Details

Advantages of Playwright

Playwright provides a one - stop automation solution, supporting multiple browsers and offering a rich set of features:

1. Multi - platform Support: Test Chromium, Firefox, and WebKit within the same codebase.
2. Built - in Tools: Include assertions, file download handling, and automatically generated waiting conditions.
3. Scalability: Allow custom features to be added through a plugin system.

📚 Summary

Playwright is a powerful tool that simplifies the workflow of cross - browser testing. With the above commands, developers can easily implement various functions such as page interaction, screenshot taking, navigation, and keyboard operations. It supports multiple browsers and platforms, ensuring the comprehensiveness and reliability of testing.