Playwright MCP

Fügen Sie ihn über den Amp VS Code-Erweiterungseinstellungsbildschirm oder durch Aktualisieren Ihrer settings.json-Datei hinzu:

"amp.mcpServers": {
  "playwright": {
    "command": "npx",
    "args": [
      "@playwright/mcp@latest"
    ]
  }
}

Amp CLI-Setup:

Fügen Sie ihn über den folgenden Befehl amp mcp add hinzu:

amp mcp add playwright -- npx @playwright/mcp@latest

Fügen Sie ihn über die Antigravity-Einstellungen oder durch Aktualisieren Ihrer Konfigurationsdatei hinzu:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Verwenden Sie die Claude Code-CLI, um den Playwright MCP-Server hinzuzufügen:

claude mcp add playwright npx @playwright/mcp@latest

Befolgen Sie die MCP-Installations-Anleitung und verwenden Sie die obige Standardkonfiguration.

Befolgen Sie die Anweisungen im Abschnitt Konfigurieren von MCP-Servern

Beispiel: Lokales Setup

Fügen Sie Folgendes zu Ihrer cline_mcp_settings.json-Datei hinzu:

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ],
      "disabled": false
    }
  }
}

Verwenden Sie die Codex-CLI, um den Playwright MCP-Server hinzuzufügen:

codex mcp add playwright npx "@playwright/mcp@latest"

Alternativ können Sie die Konfigurationsdatei ~/.codex/config.toml erstellen oder bearbeiten und Folgendes hinzufügen:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

Weitere Informationen finden Sie in der Codex MCP-Dokumentation.

Verwenden Sie die Copilot-CLI, um den Playwright MCP-Server interaktiv hinzuzufügen:

/mcp add

Alternativ können Sie die Konfigurationsdatei ~/.copilot/mcp-config.json erstellen oder bearbeiten und Folgendes hinzufügen:

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Weitere Informationen finden Sie in der Copilot CLI-Dokumentation.

Klicken Sie auf die Schaltfläche, um zu installieren:

Oder installieren Sie manuell:

Gehen Sie zu Cursor Settings -> MCP -> Add new MCP Server. Benennen Sie es nach Ihren Wünschen, verwenden Sie den Typ command mit dem Befehl npx @playwright/mcp@latest. Sie können die Konfiguration auch überprüfen oder Argumente wie Befehle hinzufügen, indem Sie auf Edit klicken.

Verwenden Sie die Factory-CLI, um den Playwright MCP-Server hinzuzufügen:

droid mcp add playwright "npx @playwright/mcp@latest"

Alternativ geben Sie /mcp im Factory-Droid ein, um eine interaktive Benutzeroberfläche zur Verwaltung von MCP-Servern zu öffnen.

Weitere Informationen finden Sie in der Factory MCP-Dokumentation.

Befolgen Sie die MCP-Installations-Anleitung und verwenden Sie die obige Standardkonfiguration.

Klicken Sie auf die Schaltfläche, um zu installieren:

Oder installieren Sie manuell:

Gehen Sie zu Advanced settings -> Extensions -> Add custom extension. Benennen Sie es nach Ihren Wünschen, verwenden Sie den Typ STDIO und setzen Sie command auf npx @playwright/mcp. Klicken Sie auf "Add Extension".

Verwenden Sie die Grok-CLI, um den Playwright MCP-Server hinzuzufügen:

grok mcp add playwright -- npx @playwright/mcp@latest

Alternativ können Sie die Konfigurationsdatei ~/.grok/config.toml erstellen oder bearbeiten und Folgendes hinzufügen:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

Weitere Informationen finden Sie in der Grok MCP-Dokumentation.

So fügen Sie den Playwright MCP-Server in der Junie-CLI hinzu:

1. Geben Sie /mcp ein
2. Drücken Sie Ctrl+A, um einen neuen MCP-Server hinzuzufügen
3. Wählen Sie Playwright aus der Liste

Alternativ fügen Sie zu .junie/mcp/mcp.json hinzu:

{
  "mcpServers": {
    "Playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ]
    }
  }
}

Weitere Informationen finden Sie in der Junie MCP-Konfigurationsdokumentation.

Befolgen Sie die MCP-Server-Dokumentation. Zum Beispiel in .kiro/settings/mcp.json:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Klicken Sie auf die Schaltfläche, um zu installieren:

Oder installieren Sie manuell:

Gehen Sie in der rechten Seitenleiste zu Program -> Install -> Edit mcp.json. Verwenden Sie die obige Standardkonfiguration.

Befolgen Sie die MCP-Server-Dokumentation. Zum Beispiel in ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": [
        "npx",
        "@playwright/mcp@latest"
      ],
      "enabled": true
    }
  }
}

Öffnen Sie das Qodo Gen-Chat-Panel in VSCode oder IntelliJ → Connect more tools → + Add new MCP → Fügen Sie die obige Standardkonfiguration ein.

Klicken Sie auf Save.

Klicken Sie auf die Schaltfläche, um zu installieren:

Oder installieren Sie manuell:

Befolgen Sie die MCP-Installations-Anleitung und verwenden Sie die obige Standardkonfiguration. Sie können den Playwright MCP-Server auch über die VS Code-CLI installieren:

# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

Nach der Installation steht der Playwright MCP-Server für die Verwendung mit Ihrem GitHub Copilot-Agenten in VS Code zur Verfügung.

Gehen Sie zu Settings -> AI -> Manage MCP Servers -> + Add, um einen MCP-Server hinzuzufügen. Verwenden Sie die obige Standardkonfiguration.

Alternativ verwenden Sie den Slash-Befehl /add-mcp in der Warp-Eingabeaufforderung und fügen Sie die obige Standardkonfiguration ein:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Befolgen Sie die Windsurf-MCP-Dokumentation. Verwenden Sie die obige Standardkonfiguration.

{
  /**
   * The browser to use.
   */
  browser?: {
    /**
     * The type of browser to use.
     */
    browserName?: 'chromium' | 'firefox' | 'webkit';

    /**
     * Keep the browser profile in memory, do not save it to disk.
     */
    isolated?: boolean;

    /**
     * Path to a user data directory for browser profile persistence.
     * Temporary directory is created by default.
     */
    userDataDir?: string;

    /**
     * Launch options passed to
     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
     *
     * This is useful for settings options like `channel`, `headless`, `executablePath`, etc.
     */
    launchOptions?: playwright.LaunchOptions;

    /**
     * Context options for the browser context.
     *
     * This is useful for settings options like `viewport`.
     */
    contextOptions?: playwright.BrowserContextOptions;

    /**
     * Chrome DevTools Protocol endpoint to connect to an existing browser instance in case of Chromium family browsers.
     */
    cdpEndpoint?: string;

    /**
     * CDP headers to send with the connect request.
     */
    cdpHeaders?: Record<string, string>;

    /**
     * Timeout in milliseconds for connecting to CDP endpoint. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
     */
    cdpTimeout?: number;

    /**
     * Remote endpoint to connect to an existing Playwright server. May be a
     * WebSocket URL string, or a [ConnectOptions] object that mirrors the
     * `connectOptions` shape used by the test runner. When passed as an object,
     * `exposeNetwork`, `headers`, `slowMo`, and `timeout` are forwarded to the
     * underlying connect call.
     */
    remoteEndpoint?: string | playwright.ConnectOptions & { endpoint: string };

    /**
     * Paths to TypeScript files to add as initialization scripts for Playwright page.
     */
    initPage?: string[];

    /**
     * Paths to JavaScript files to add as initialization scripts.
     * The scripts will be evaluated in every page before any of the page's scripts.
     */
    initScript?: string[];
  },

  /**
   * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
   * config is ignored.
   * Requires the "Playwright Extension" to be installed.
   */
  extension?: boolean;

  server?: {
    /**
     * The port to listen on for SSE or MCP transport.
     */
    port?: number;

    /**
     * The host to bind the server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.
     */
    host?: string;

    /**
     * The hosts this server is allowed to serve from. Defaults to the host server is bound to.
     * This is not for CORS, but rather for the DNS rebinding protection.
     */
    allowedHosts?: string[];
  },

  /**
   * List of enabled tool capabilities. Possible values:
   *   - 'core': Core browser automation features.
   *   - 'pdf': PDF generation and manipulation.
   *   - 'vision': Coordinate-based interactions.
   *   - 'devtools': Developer tools features.
   */
  capabilities?: ToolCapability[];

  /**
   * Whether to save the Playwright session into the output directory.
   */
  saveSession?: boolean;

  /**
   * Reuse the same browser context between all connected HTTP clients.
   */
  sharedBrowserContext?: boolean;

  /**
   * Secrets are used to replace matching plain text in the tool responses to prevent the LLM
   * from accidentally getting sensitive data. It is a convenience and not a security feature,
   * make sure to always examine information coming in and from the tool on the client.
   */
  secrets?: Record<string, string>;

  /**
   * The directory to save output files.
   */
  outputDir?: string;

  /**
   * Threshold for evicting old output files, in bytes.
   */
  outputMaxSize?: number;

  console?: {
    /**
     * The level of console messages to return. Each level includes the messages of more severe levels. Defaults to "info".
     */
    level?: 'error' | 'warning' | 'info' | 'debug';
  },

  network?: {
    /**
     * List of origins to allow the browser to request. Default is to allow all. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    allowedOrigins?: string[];

    /**
     * List of origins to block the browser to request. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    blockedOrigins?: string[];
  };

  /**
   * Specify the attribute to use for test ids, defaults to "data-testid".
   */
  testIdAttribute?: string;

  timeouts?: {
    /*
     * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
     */
    action?: number;

    /*
     * Configures default navigation timeout: https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout. Defaults to 60000ms.
     */
    navigation?: number;

    /**
     * Configures default expect timeout: https://playwright.dev/docs/test-timeouts#expect-timeout. Defaults to 5000ms.
     */
    expect?: number;

    /**
     * How long to wait after each action for triggered work (navigations, requests) to settle before responding. Defaults to 500ms.
     */
    settle?: number;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "auto". Defaults to "auto", which sends images if the client can display them.
   */
  imageResponses?: 'allow' | 'omit';

  snapshot?: {
    /**
     * When taking snapshots for responses, specifies the mode to use.
     */
    mode?: 'full' | 'none';

    /**
     * Whether to include each element's bounding box as [box=x,y,width,height] in snapshots.
     * Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect).
     */
    boxes?: boolean;
  };

  /**
   * allowUnrestrictedFileAccess acts as a guardrail to prevent the LLM from accidentally
   * wandering outside its intended workspace. It is a convenience defense to catch unintended
   * file access, not a secure boundary; a deliberate attempt to reach other directories can be
   * easily worked around, so always rely on client-level permissions for true security.
   */
  allowUnrestrictedFileAccess?: boolean;

  /**
   * Specify the language to use for code generation.
   */
  codegen?: 'typescript' | 'python' | 'java' | 'csharp' | 'none';
}

HINWEIS: Die Docker-Implementierung unterstützt derzeit nur Headless-Chromium.

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

Oder wenn Sie den Container lieber als langlebigen Dienst ausführen möchten, anstatt ihn vom MCP-Client starten zu lassen, verwenden Sie:

docker run -d -i --rm --init --pull=always \
  --entrypoint node \
  --name playwright \
  -p 8931:8931 \
  mcr.microsoft.com/playwright/mcp \
  /app/cli.js --headless --browser chromium --no-sandbox --port 8931 --host 0.0.0.0

Der Server lauscht auf Host-Port 8931 und kann von jedem MCP-Client erreicht werden.

Sie können das Docker-Image selbst erstellen.

docker build -t mcr.microsoft.com/playwright/mcp .

import http from 'http';

import { createConnection } from '@playwright/mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

http.createServer(async (req, res) => {
  // ...

  // Creates a headless Playwright MCP server with SSE transport
  const connection = await createConnection({ browser: { launchOptions: { headless: true } } });
  const transport = new SSEServerTransport('/messages', res);
  await connection.connect(transport);

  // ...
});

• browser_click
  • Titel: Klicken
  • Beschreibung: Führt einen Klick auf einer Webseite aus
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • doubleClick (boolesch, optional): Gibt an, ob ein Doppelklick anstelle eines einfachen Klicks ausgeführt werden soll
    • button (Zeichenkette, optional): Zu klickende Maustaste, standardmäßig links
    • modifiers (Array, optional): Zu drückende Modifikatortasten
  • Schreibgeschützt: false

• browser_close
  • Titel: Browser schließen
  • Beschreibung: Schließt die Seite
  • Parameter: Keine
  • Schreibgeschützt: false

• browser_console_messages
  • Titel: Konsolenmeldungen abrufen
  • Beschreibung: Gibt alle Konsolenmeldungen zurück
  • Parameter:
    • level (Zeichenkette): Ebene der zurückzugebenden Konsolenmeldungen. Jede Ebene enthält die Meldungen der schwerwiegenderen Ebenen. Standardmäßig "info".
    • all (boolesch, optional): Gibt alle Konsolenmeldungen seit Beginn der Sitzung zurück, nicht nur seit der letzten Navigation. Standardmäßig false.
    • filename (Zeichenkette, optional): Dateiname, unter dem die Konsolenmeldungen gespeichert werden sollen. Wenn nicht angegeben, werden die Meldungen als Text zurückgegeben.
  • Schreibgeschützt: true

• browser_drag
  • Titel: Maus ziehen
  • Beschreibung: Führt Drag-and-Drop zwischen zwei Elementen aus
  • Parameter:
    • startElement (Zeichenkette, optional): Für Menschen lesbare Quell-Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • startTarget (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • endElement (Zeichenkette, optional): Für Menschen lesbare Ziel-Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • endTarget (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
  • Schreibgeschützt: false

• browser_drop
  • Titel: Dateien oder Daten auf ein Element ablegen
  • Beschreibung: Legt Dateien oder MIME-typisierte Daten auf einem Element ab, als ob sie von außerhalb der Seite gezogen würden. Mindestens einer der Parameter "paths" oder "data" muss angegeben werden.
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • paths (Array, optional): Absolute Pfade zu den Dateien, die auf dem Element abgelegt werden sollen.
    • data (Objekt, optional): Abzulegende Daten als Zuordnung von MIME-Typ zu Zeichenkettenwert (z. B. {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • Schreibgeschützt: false

• browser_evaluate
  • Titel: JavaScript auswerten
  • Beschreibung: Wertet einen JavaScript-Ausdruck auf der Seite oder einem Element aus
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette, optional): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • function (Zeichenkette): () => { /* code / } oder (element) => { / code */ }, wenn ein Element angegeben ist
    • filename (Zeichenkette, optional): Dateiname, unter dem das Ergebnis gespeichert werden soll. Wenn nicht angegeben, wird das Ergebnis als Text zurückgegeben.
  • Schreibgeschützt: false

• browser_file_upload
  • Titel: Dateien hochladen
  • Beschreibung: Lädt eine oder mehrere Dateien hoch
  • Parameter:
    • paths (Array, optional): Die absoluten Pfade zu den hochzuladenden Dateien. Kann eine einzelne Datei oder mehrere Dateien sein. Wenn weggelassen, wird die Dateiauswahl abgebrochen.
  • Schreibgeschützt: false

• browser_fill_form
  • Titel: Formular ausfüllen
  • Beschreibung: Füllt mehrere Formularfelder aus
  • Parameter:
    • fields (Array): Auszufüllende Felder
  • Schreibgeschützt: false

• browser_find
  • Titel: Im Seiten-Snapshot suchen
  • Beschreibung: Durchsucht den Barrierefreiheits-Snapshot der aktuellen Seite nach Text oder einem regulären Ausdruck. Gibt passende Snapshot-Knoten mit einigen Zeilen umgebenden Kontexts zurück (wie Suchausschnitte), jeweils unter ihrem Pfad von der Wurzel des Baums angezeigt, was günstiger ist als das Erfassen des gesamten Snapshots, wenn Sie nur ein Element und seine Referenz lokalisieren müssen.
  • Parameter:
    • text (Zeichenkette, optional): Klartext, der im Seiten-Snapshot gesucht werden soll (Groß-/Kleinschreibung nicht beachtende Teilzeichenketten-Übereinstimmung). Geben Sie entweder Text oder Regex an, nicht beides.
    • regex (Zeichenkette, optional): Regulärer Ausdruck, der im Seiten-Snapshot gesucht werden soll. Die Übereinstimmung ist standardmäßig Groß-/Kleinschreibung beachtend; umgeben Sie das Muster mit Schrägstrichen, um Flags hinzuzufügen, z. B. "/error/i" für Groß-/Kleinschreibung nicht beachtend. Geben Sie entweder Text oder Regex an, nicht beides.
  • Schreibgeschützt: true

• browser_handle_dialog
  • Titel: Dialog behandeln
  • Beschreibung: Behandelt einen Dialog
  • Parameter:
    • accept (boolesch): Gibt an, ob der Dialog akzeptiert werden soll.
    • promptText (Zeichenkette, optional): Der Text der Eingabeaufforderung im Falle eines Eingabeaufforderungs-Dialogs.
  • Schreibgeschützt: false

• browser_hover
  • Titel: Maus darüber bewegen
  • Beschreibung: Bewegt die Maus über ein Element auf der Seite
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
  • Schreibgeschützt: false

• browser_navigate
  • Titel: Zu einer URL navigieren
  • Beschreibung: Navigiert zu einer URL
  • Parameter:
    • url (Zeichenkette): Die URL, zu der navigiert werden soll
  • Schreibgeschützt: false

• browser_navigate_back
  • Titel: Zurück gehen
  • Beschreibung: Geht zur vorherigen Seite im Verlauf zurück
  • Parameter: Keine
  • Schreibgeschützt: false

• browser_network_request
  • Titel: Netzwerkanfragedetails anzeigen
  • Beschreibung: Gibt vollständige Details (Header und Body) einer einzelnen Netzwerkanfrage zurück, oder einen einzelnen Teil, wenn part gesetzt ist. Verwenden Sie die Nummer aus browser_network_requests.
  • Parameter:
    • index (Ganzzahl): 1-basierter Index der Anfrage, wie von browser_network_requests ausgegeben.
    • part (Zeichenkette, optional): Gibt nur diesen Teil der Anfrage zurück. Weglassen, um vollständige Details zurückzugeben.
    • filename (Zeichenkette, optional): Dateiname, unter dem das Ergebnis gespeichert werden soll. Wenn nicht angegeben, wird die Ausgabe als Text zurückgegeben.
  • Schreibgeschützt: true

• browser_network_requests
  • Titel: Netzwerkanfragen auflisten
  • Beschreibung: Gibt eine nummerierte Liste der Netzwerkanfragen seit dem Laden der Seite zurück. Verwenden Sie browser_network_request mit der Nummer, um vollständige Details zu erhalten.
  • Parameter:
    • static (boolesch): Gibt an, ob erfolgreiche statische Ressourcen wie Bilder, Schriftarten, Skripte usw. eingeschlossen werden sollen. Standardmäßig false.
    • filter (Zeichenkette, optional): Gibt nur Anfragen zurück, deren URL diesem Regexp entspricht (z. B. "/api/.*user").
    • filename (Zeichenkette, optional): Dateiname, unter dem die Netzwerkanfragen gespeichert werden sollen. Wenn nicht angegeben, werden die Anfragen als Text zurückgegeben.
  • Schreibgeschützt: true

• browser_press_key
  • Titel: Eine Taste drücken
  • Beschreibung: Drückt eine Taste auf der Tastatur
  • Parameter:
    • key (Zeichenkette): Name der zu drückenden Taste oder ein zu erzeugendes Zeichen, wie ArrowLeft oder a
  • Schreibgeschützt: false

• browser_resize
  • Titel: Browserfenster skalieren
  • Beschreibung: Skaliert das Browserfenster
  • Parameter:
    • width (Zahl): Breite des Browserfensters
    • height (Zahl): Höhe des Browserfensters
  • Schreibgeschützt: false

• browser_run_code_unsafe
  • Titel: Playwright-Code ausführen (unsicher)
  • Beschreibung: Führt einen Playwright-Codeausschnitt aus. Unsicher: führt beliebiges JavaScript im Playwright-Serverprozess aus und ist RCE-äquivalent.
  • Parameter:
    • code (Zeichenkette, optional): Eine JavaScript-Funktion, die auszuführenden Playwright-Code enthält. Sie wird mit einem einzelnen Argument, page, aufgerufen, das Sie für jede Seiteninteraktion verwenden können. Zum Beispiel: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (Zeichenkette, optional): Code aus der angegebenen Datei laden. Wenn sowohl Code als auch Dateiname angegeben sind, wird der Code ignoriert.
  • Schreibgeschützt: false

• browser_select_option
  • Titel: Option auswählen
  • Beschreibung: Wählt eine Option in einem Dropdown aus
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • values (Array): Array von Werten, die im Dropdown ausgewählt werden sollen. Dies kann ein einzelner Wert oder mehrere Werte sein.
  • Schreibgeschützt: false

• browser_snapshot
  • Titel: Seiten-Snapshot
  • Beschreibung: Erfasst den Barrierefreiheits-Snapshot der aktuellen Seite, dies ist besser als ein Screenshot
  • Parameter:
    • target (Zeichenkette, optional): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • filename (Zeichenkette, optional): Speichert den Snapshot in einer Markdown-Datei, anstatt ihn in der Antwort zurückzugeben.
    • depth (Zahl, optional): Begrenzt die Tiefe des Snapshot-Baums
    • boxes (boolesch, optional): Fügt die Begrenzungsbox jedes Elements als [box=x,y,width,height] in den Snapshot ein. Koordinaten sind viewport-relativ, in CSS-Pixeln (Element.getBoundingClientRect)
  • Schreibgeschützt: true

• browser_take_screenshot
  • Titel: Einen Screenshot aufnehmen
  • Beschreibung: Nimmt einen Screenshot der aktuellen Seite auf. Sie können keine Aktionen basierend auf dem Screenshot ausführen, verwenden Sie browser_snapshot für Aktionen.
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette, optional): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • type (Zeichenkette, optional): Bildformat für den Screenshot. Wenn nicht gesetzt, wird es aus der Dateinamenerweiterung abgeleitet, andernfalls png.
    • filename (Zeichenkette, optional): Dateiname, unter dem der Screenshot gespeichert werden soll. Standardmäßig page-{timestamp}.{png|jpeg|webp}, wenn nicht angegeben. Bevorzugen Sie relative Dateinamen, um innerhalb des Ausgabeverzeichnisses zu bleiben.
    • fullPage (boolesch, optional): Wenn true, wird ein Screenshot der gesamten scrollbaren Seite aufgenommen, anstatt des aktuell sichtbaren Viewports. Kann nicht mit Element-Screenshots verwendet werden.
    • scale (Zeichenkette): Skalierung der Bildauflösung. "css" erzeugt einen Screenshot in CSS-Pixeln (kleiner, konsistent über Geräte hinweg). "device" erzeugt einen hochauflösenden Screenshot mit Gerätepixeln (größer, berücksichtigt das Gerätepixelverhältnis). Standard ist css.
  • Schreibgeschützt: true

• browser_type
  • Titel: Text eingeben
  • Beschreibung: Gibt Text in ein bearbeitbares Element ein
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
    • text (Zeichenkette): Text, der in das Element eingegeben werden soll
    • submit (boolesch, optional): Gibt an, ob der eingegebene Text übermittelt werden soll (danach Enter drücken)
    • slowly (boolesch, optional): Gibt an, ob jeweils ein Zeichen auf einmal eingegeben werden soll. Nützlich zum Auslösen von Tastenhandlern auf der Seite. Standardmäßig wird der gesamte Text auf einmal ausgefüllt.
  • Schreibgeschützt: false

• browser_wait_for
  • Titel: Warten auf
  • Beschreibung: Warten, bis Text erscheint oder verschwindet oder eine bestimmte Zeit vergeht
  • Parameter:
    • time (Zahl, optional): Die Wartezeit in Sekunden
    • text (Zeichenkette, optional): Der Text, auf den gewartet werden soll
    • textGone (Zeichenkette, optional): Der Text, auf dessen Verschwinden gewartet werden soll
  • Schreibgeschützt: false

• browser_tabs
  • Titel: Tabs verwalten
  • Beschreibung: Browser-Tab auflisten, erstellen, schließen oder auswählen.
  • Parameter:
    • action (Zeichenkette): Auszuführende Operation
    • index (Zahl, optional): Tab-Index, verwendet für Schließen/Auswählen. Wenn beim Schließen weggelassen, wird der aktuelle Tab geschlossen.
    • url (Zeichenkette, optional): URL, zu der im neuen Tab navigiert werden soll, verwendet für Neu.
  • Schreibgeschützt: false

• browser_get_config
  • Titel: Konfiguration abrufen
  • Beschreibung: Die endgültig aufgelöste Konfiguration nach dem Zusammenführen von CLI-Optionen, Umgebungsvariablen und Konfigurationsdatei abrufen.
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_network_state_set
  • Titel: Netzwerkstatus festlegen
  • Beschreibung: Setzt den Browser-Netzwerkstatus auf online oder offline. Im Offline-Modus schlagen alle Netzwerkanfragen fehl.
  • Parameter:
    • state (Zeichenkette): Auf "offline" setzen, um den Offline-Modus zu simulieren, "online", um die Netzwerkverbindung wiederherzustellen
  • Schreibgeschützt: false

• browser_route
  • Titel: Netzwerkanfragen simulieren
  • Beschreibung: Eine Route einrichten, um Netzwerkanfragen zu simulieren, die einem URL-Muster entsprechen
  • Parameter:
    • pattern (Zeichenkette): URL-Muster zum Abgleichen (z. B. "/api/users", "/*.{png,jpg}")
    • status (Zahl, optional): HTTP-Statuscode, der zurückgegeben werden soll (Standard: 200)
    • body (Zeichenkette, optional): Antworttext (Text oder JSON-Zeichenkette)
    • contentType (Zeichenkette, optional): Content-Type-Header (z. B. "application/json", "text/html")
    • headers (Array, optional): Header, die im Format "Name: Wert" hinzugefügt werden sollen
    • removeHeaders (Zeichenkette, optional): Kommagetrennte Liste von Header-Namen, die aus der Anfrage entfernt werden sollen
  • Schreibgeschützt: false

• browser_route_list
  • Titel: Netzwerk-Routen auflisten
  • Beschreibung: Alle aktiven Netzwerk-Routen auflisten
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_unroute
  • Titel: Netzwerk-Routen entfernen
  • Beschreibung: Netzwerk-Routen entfernen, die einem Muster entsprechen (oder alle Routen, wenn kein Muster angegeben ist)
  • Parameter:
    • pattern (Zeichenkette, optional): URL-Muster zum Entfernen der Route (weglassen, um alle Routen zu entfernen)
  • Schreibgeschützt: false

• browser_cookie_clear
  • Titel: Cookies löschen
  • Beschreibung: Alle Cookies löschen
  • Parameter: Keine
  • Schreibgeschützt: false

• browser_cookie_delete
  • Titel: Cookie löschen
  • Beschreibung: Ein bestimmtes Cookie löschen
  • Parameter:
    • name (Zeichenkette): Name des zu löschenden Cookies
  • Schreibgeschützt: false

• browser_cookie_get
  • Titel: Cookie abrufen
  • Beschreibung: Ein bestimmtes Cookie anhand des Namens abrufen
  • Parameter:
    • name (Zeichenkette): Name des abzurufenden Cookies
  • Schreibgeschützt: true

• browser_cookie_list
  • Titel: Cookies auflisten
  • Beschreibung: Alle Cookies auflisten (optional nach Domain/Pfad gefiltert)
  • Parameter:
    • domain (Zeichenkette, optional): Cookies nach Domain filtern
    • path (Zeichenkette, optional): Cookies nach Pfad filtern
  • Schreibgeschützt: true

• browser_cookie_set
  • Titel: Cookie festlegen
  • Beschreibung: Ein Cookie mit optionalen Flags festlegen (Domain, Pfad, Ablauf, httpOnly, secure, sameSite)
  • Parameter:
    • name (Zeichenkette): Cookie-Name
    • value (Zeichenkette): Cookie-Wert
    • domain (Zeichenkette, optional): Cookie-Domain
    • path (Zeichenkette, optional): Cookie-Pfad
    • expires (Zahl, optional): Cookie-Ablauf als Unix-Zeitstempel
    • httpOnly (Boolescher Wert, optional): Ob das Cookie nur über HTTP zugänglich ist
    • secure (Boolescher Wert, optional): Ob das Cookie sicher ist
    • sameSite (Zeichenkette, optional): SameSite-Attribut des Cookies
  • Schreibgeschützt: false

• browser_localstorage_clear
  • Titel: localStorage leeren
  • Beschreibung: Den gesamten localStorage leeren
  • Parameter: Keine
  • Schreibgeschützt: false

• browser_localstorage_delete
  • Titel: localStorage-Element löschen
  • Beschreibung: Ein localStorage-Element löschen
  • Parameter:
    • key (Zeichenkette): Zu löschender Schlüssel
  • Schreibgeschützt: false

• browser_localstorage_get
  • Titel: localStorage-Element abrufen
  • Beschreibung: Ein localStorage-Element anhand des Schlüssels abrufen
  • Parameter:
    • key (Zeichenkette): Abzurufender Schlüssel
  • Schreibgeschützt: true

• browser_localstorage_list
  • Titel: localStorage auflisten
  • Beschreibung: Alle localStorage-Schlüssel-Wert-Paare auflisten
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_localstorage_set
  • Titel: localStorage-Element festlegen
  • Beschreibung: Ein localStorage-Element festlegen
  • Parameter:
    • key (Zeichenkette): Festzulegender Schlüssel
    • value (Zeichenkette): Festzulegender Wert
  • Schreibgeschützt: false

• browser_sessionstorage_clear
  • Titel: sessionStorage leeren
  • Beschreibung: Den gesamten sessionStorage leeren
  • Parameter: Keine
  • Schreibgeschützt: false

• browser_sessionstorage_delete
  • Titel: sessionStorage-Element löschen
  • Beschreibung: Ein sessionStorage-Element löschen
  • Parameter:
    • key (Zeichenkette): Zu löschender Schlüssel
  • Schreibgeschützt: false

• browser_sessionstorage_get
  • Titel: sessionStorage-Element abrufen
  • Beschreibung: Ein sessionStorage-Element anhand des Schlüssels abrufen
  • Parameter:
    • key (Zeichenkette): Abzurufender Schlüssel
  • Schreibgeschützt: true

• browser_sessionstorage_list
  • Titel: sessionStorage auflisten
  • Beschreibung: Alle sessionStorage-Schlüssel-Wert-Paare auflisten
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_sessionstorage_set
  • Titel: sessionStorage-Element festlegen
  • Beschreibung: Ein sessionStorage-Element festlegen
  • Parameter:
    • key (Zeichenkette): Festzulegender Schlüssel
    • value (Zeichenkette): Festzulegender Wert
  • Schreibgeschützt: false

• browser_set_storage_state
  • Titel: Speicherzustand wiederherstellen
  • Beschreibung: Speicherzustand (Cookies, lokaler Speicher) aus einer Datei wiederherstellen. Dabei werden vorhandene Cookies und lokaler Speicher vor der Wiederherstellung gelöscht.
  • Parameter:
    • filename (Zeichenkette): Pfad zur Speicherzustandsdatei, aus der wiederhergestellt werden soll
  • Schreibgeschützt: false

• browser_storage_state
  • Titel: Speicherzustand speichern
  • Beschreibung: Speicherzustand (Cookies, lokaler Speicher) zur späteren Wiederverwendung in einer Datei speichern
  • Parameter:
    • filename (Zeichenkette, optional): Dateiname zum Speichern des Speicherzustands. Standardmäßig storage-state-{timestamp}.json, wenn nicht angegeben.
  • Schreibgeschützt: true

• browser_annotate
  • Titel: Aktuelle Seite annotieren
  • Beschreibung: Das Playwright-Dashboard im Annotationsmodus für die aktuelle Seite öffnen und warten, bis der Benutzer Annotationen zeichnet. Gibt den annotierten Screenshot, die ARIA-Momentaufnahme und die Liste der Annotationen zurück.
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_hide_highlight
  • Titel: Element-Hervorhebung ausblenden
  • Beschreibung: Eine zuvor für das Element hinzugefügte Hervorhebungsüberlagerung entfernen.
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die beim Hinzufügen der Hervorhebung verwendet wurde; muss mit dem an browser_highlight übergebenen Wert übereinstimmen.
    • target (Zeichenkette, optional): Exakte Ziel-Elementreferenz aus der Seiten-Momentaufnahme oder ein eindeutiger Element-Selektor
  • Schreibgeschützt: true

• browser_highlight
  • Titel: Element hervorheben
  • Beschreibung: Eine dauerhafte Hervorhebungsüberlagerung um das Element auf der Seite anzeigen.
  • Parameter:
    • element (Zeichenkette, optional): Für Menschen lesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus der Seiten-Momentaufnahme oder ein eindeutiger Element-Selektor
    • style (Zeichenkette, optional): Zusätzliches Inline-CSS, das auf die Hervorhebungsüberlagerung angewendet wird, z. B. "outline: 2px dashed red".
  • Schreibgeschützt: true

• browser_resume
  • Titel: Pausierte Skriptausführung fortsetzen
  • Beschreibung: Die Skriptausführung nach einer Pause fortsetzen. Wenn mit step auf true aufgerufen, wird die Ausführung vor der nächsten Aktion erneut pausiert.
  • Parameter:
    • step (Boolescher Wert, optional): Wenn true, wird die Ausführung vor der nächsten Aktion erneut pausiert, was eine schrittweise Fehlersuche ermöglicht.
    • location (Zeichenkette, optional): Ausführung an einer bestimmten : pausieren, z. B. "example.spec.ts:42".
  • Schreibgeschützt: false

• browser_start_recording
  • Titel: Aufzeichnung von Benutzeraktionen starten
  • Beschreibung: Aufzeichnung der Aktionen starten, die der Benutzer im Browser als Playwright-Code ausführt. Verwenden Sie dies, wenn der Benutzer einen Ablauf manuell demonstrieren möchte. Rufen Sie browser_stop_recording auf, wenn der Benutzer angibt, fertig zu sein, um die aufgezeichneten Aktionen abzurufen.
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_start_tracing
  • Titel: Tracing starten
  • Beschreibung: Trace-Aufzeichnung starten
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_start_video
  • Titel: Video starten
  • Beschreibung: Videoaufzeichnung starten
  • Parameter:
    • filename (Zeichenkette, optional): Dateiname zum Speichern des Videos.
    • size (Objekt, optional): Videogröße
  • Schreibgeschützt: true

• browser_stop_recording
  • Titel: Aufzeichnung von Benutzeraktionen stoppen
  • Beschreibung: Die mit browser_start_recording gestartete Aufzeichnung stoppen und die aufgezeichneten Aktionen als Playwright-Code zurückgeben.
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_stop_tracing
  • Titel: Tracing stoppen
  • Beschreibung: Trace-Aufzeichnung stoppen
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_stop_video
  • Titel: Video stoppen
  • Beschreibung: Videoaufzeichnung stoppen
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_video_chapter
  • Titel: Videokapitel
  • Beschreibung: Ein Kapitelmarker zur Videoaufzeichnung hinzufügen. Zeigt eine Vollbild-Kapitelkarte mit unscharfem Hintergrund an.
  • Parameter:
    • title (Zeichenkette): Kapiteltitel
    • description (Zeichenkette, optional): Kapitelbeschreibung
    • duration (Zahl, optional): Dauer in Millisekunden, wie lange die Kapitelkarte angezeigt wird
  • Schreibgeschützt: true

• browser_video_hide_actions
  • Titel: Aktionsüberlagerungen ausblenden
  • Beschreibung: Das Annotieren von Aktionen auf der Seite stoppen.
  • Parameter: Keine
  • Schreibgeschützt: true

• browser_video_show_actions
  • Titel: Aktions-Overlays anzeigen
  • Beschreibung: Markiert nachfolgende Aktionen auf der Seite mit einem Hinweis, der die Aktion benennt und das Zielelement hervorhebt. Nützlich während Videoaufnahmen oder Screencasts.
  • Parameter:
    • duration (Zahl, optional): Wie lange jede Aktionsbeschriftung auf dem Bildschirm bleibt, in Millisekunden. Standard ist 500.
    • position (Zeichenkette, optional): Wo die Aktionsbeschriftung relativ zur Seite platziert wird. Standard ist oben rechts.
    • cursor (Zeichenkette, optional): Cursor-Dekoration für Zeigeraktionen. „pointer“ (Standard) animiert einen Mauszeiger vom vorherigen Aktionspunkt zum nächsten; „none“ deaktiviert die Cursor-Dekoration.
  • Schreibgeschützt: true

• browser_mouse_click_xy
  • Titel: Klicken
  • Beschreibung: Maustaste an einer bestimmten Position klicken
  • Parameter:
    • x (Zahl): X-Koordinate
    • y (Zahl): Y-Koordinate
    • button (Zeichenkette, optional): Zu klickende Taste, Standard ist links
    • clickCount (Zahl, optional): Anzahl der Klicks, Standard ist 1
    • delay (Zahl, optional): Wartezeit zwischen Maus gedrückt und Maus losgelassen in Millisekunden, Standard ist 0
  • Schreibgeschützt: false

• browser_mouse_down
  • Titel: Maus gedrückt halten
  • Beschreibung: Maus gedrückt halten
  • Parameter:
    • button (Zeichenkette, optional): Zu drückende Taste, Standard ist links
  • Schreibgeschützt: false

• browser_mouse_drag_xy
  • Titel: Maus ziehen
  • Beschreibung: Linke Maustaste zu einer bestimmten Position ziehen
  • Parameter:
    • startX (Zahl): Start-X-Koordinate
    • startY (Zahl): Start-Y-Koordinate
    • endX (Zahl): End-X-Koordinate
    • endY (Zahl): End-Y-Koordinate
  • Schreibgeschützt: false

• browser_mouse_move_xy
  • Titel: Maus bewegen
  • Beschreibung: Maus zu einer bestimmten Position bewegen
  • Parameter:
    • x (Zahl): X-Koordinate
    • y (Zahl): Y-Koordinate
  • Schreibgeschützt: false

• browser_mouse_up
  • Titel: Maus loslassen
  • Beschreibung: Maus loslassen
  • Parameter:
    • button (Zeichenkette, optional): Loszulassende Taste, Standard ist links
  • Schreibgeschützt: false

• browser_mouse_wheel
  • Titel: Mausrad scrollen
  • Beschreibung: Mausrad scrollen
  • Parameter:
    • deltaX (Zahl): X-Delta
    • deltaY (Zahl): Y-Delta
  • Schreibgeschützt: false

• browser_pdf_save
  • Titel: Als PDF speichern
  • Beschreibung: Seite als PDF speichern
  • Parameter:
    • filename (Zeichenkette, optional): Dateiname zum Speichern der PDF. Standard ist page-{timestamp}.pdf, falls nicht angegeben. Bevorzugen Sie relative Dateinamen, um innerhalb des Ausgabeverzeichnisses zu bleiben.
  • Schreibgeschützt: true

• browser_generate_locator
  • Titel: Locator für Element erstellen
  • Beschreibung: Locator für das angegebene Element zur Verwendung in Tests generieren
  • Parameter:
    • element (Zeichenkette, optional): Menschenlesbare Elementbeschreibung, die verwendet wird, um die Berechtigung zur Interaktion mit dem Element zu erhalten
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot oder ein eindeutiger Element-Selektor
  • Schreibgeschützt: true

• browser_verify_element_visible
  • Titel: Element sichtbar überprüfen
  • Beschreibung: Überprüfen, ob das Element auf der Seite sichtbar ist
  • Parameter:
    • role (Zeichenkette): ROLLE des Elements. Kann im Snapshot so gefunden werden: - {ROLE} "Accessible Name":
    • accessibleName (Zeichenkette): ZUGÄNGLICHER_NAME des Elements. Kann im Snapshot so gefunden werden: - role "{ACCESSIBLE_NAME}"
  • Schreibgeschützt: false

• browser_verify_list_visible
  • Titel: Liste sichtbar überprüfen
  • Beschreibung: Überprüfen, ob die Liste auf der Seite sichtbar ist
  • Parameter:
    • element (Zeichenkette): Menschenlesbare Listenbeschreibung
    • target (Zeichenkette): Exakte Ziel-Elementreferenz, die auf die Liste verweist
    • items (Array): Zu überprüfende Elemente
  • Schreibgeschützt: false

• browser_verify_text_visible
  • Titel: Text sichtbar überprüfen
  • Beschreibung: Überprüfen, ob der Text auf der Seite sichtbar ist. Bevorzugen Sie browser_verify_element_visible, wenn möglich.
  • Parameter:
    • text (Zeichenkette): TEXT zur Überprüfung. Kann im Snapshot so gefunden werden: - role "Accessible Name": {TEXT} oder so: - text: {TEXT}
  • Schreibgeschützt: false

• browser_verify_value
  • Titel: Wert überprüfen
  • Beschreibung: Elementwert überprüfen
  • Parameter:
    • type (Zeichenkette): Typ des Elements
    • element (Zeichenkette): Menschenlesbare Elementbeschreibung
    • target (Zeichenkette): Exakte Ziel-Elementreferenz aus dem Seiten-Snapshot
    • value (Zeichenkette): Zu überprüfender Wert. Für Kontrollkästchen verwenden Sie „true“ oder „false“.
  • Schreibgeschützt: false