Playwright MCP

Ajoutez via l'écran des paramètres de l'extension VS Code Amp ou en mettant à jour votre fichier settings.json :

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

Configuration CLI Amp :

Ajoutez via la commande amp mcp add ci-dessous

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

Ajoutez via les paramètres Antigravity ou en mettant à jour votre fichier de configuration :

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

Utilisez la CLI Claude Code pour ajouter le serveur Playwright MCP :

claude mcp add playwright npx @playwright/mcp@latest

Suivez le guide d'installation MCP, utilisez la configuration standard ci-dessus.

Suivez les instructions de la section Configuration des serveurs MCP

Exemple : Configuration locale

Ajoutez ce qui suit à votre fichier cline_mcp_settings.json :

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

Utilisez la CLI Codex pour ajouter le serveur Playwright MCP :

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

Alternativement, créez ou modifiez le fichier de configuration ~/.codex/config.toml et ajoutez :

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

Pour plus d'informations, consultez la documentation Codex MCP.

Utilisez la CLI Copilot pour ajouter interactivement le serveur Playwright MCP :

/mcp add

Alternativement, créez ou modifiez le fichier de configuration ~/.copilot/mcp-config.json et ajoutez :

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

Pour plus d'informations, consultez la documentation CLI Copilot.

Cliquez sur le bouton pour installer :

Ou installez manuellement :

Allez dans Cursor Settings -> MCP -> Add new MCP Server. Nommez à votre convenance, utilisez le type command avec la commande npx @playwright/mcp@latest. Vous pouvez également vérifier la configuration ou ajouter des arguments de commande en cliquant sur Edit.

Utilisez la CLI Factory pour ajouter le serveur Playwright MCP :

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

Alternativement, tapez /mcp dans le droid Factory pour ouvrir une interface utilisateur interactive pour gérer les serveurs MCP.

Pour plus d'informations, consultez la documentation Factory MCP.

Suivez le guide d'installation MCP, utilisez la configuration standard ci-dessus.

Cliquez sur le bouton pour installer :

Ou installez manuellement :

Allez dans Advanced settings -> Extensions -> Add custom extension. Nommez à votre convenance, utilisez le type STDIO, et définissez le command sur npx @playwright/mcp. Cliquez sur "Add Extension".

Utilisez la CLI Grok pour ajouter le serveur Playwright MCP :

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

Alternativement, créez ou modifiez le fichier de configuration ~/.grok/config.toml et ajoutez :

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

Pour plus d'informations, consultez la documentation Grok MCP.

Pour ajouter le serveur Playwright MCP dans la CLI Junie :

1. Tapez /mcp
2. Appuyez sur Ctrl+A pour ajouter un nouveau serveur MCP
3. Sélectionnez Playwright dans la liste

Alternativement, ajoutez à .junie/mcp/mcp.json :

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

Pour plus d'informations, consultez la documentation de configuration Junie MCP.

Suivez la documentation des serveurs MCP. Par exemple dans .kiro/settings/mcp.json :

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

Cliquez sur le bouton pour installer :

Ou installez manuellement :

Allez dans Program dans la barre latérale droite -> Install -> Edit mcp.json. Utilisez la configuration standard ci-dessus.

Suivez la documentation des serveurs MCP. Par exemple dans ~/.config/opencode/opencode.json :

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

Ouvrez le panneau de chat Qodo Gen dans VSCode ou IntelliJ → Connecter plus d'outils → + Ajouter un nouveau MCP → Collez la configuration standard ci-dessus.

Cliquez sur Save.

Cliquez sur le bouton pour installer :

Ou installez manuellement :

Suivez le guide d'installation MCP, utilisez la configuration standard ci-dessus. Vous pouvez également installer le serveur Playwright MCP en utilisant la CLI VS Code :

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

Après l'installation, le serveur Playwright MCP sera disponible pour une utilisation avec votre agent GitHub Copilot dans VS Code.

Allez dans Settings -> AI -> Manage MCP Servers -> + Add pour ajouter un serveur MCP. Utilisez la configuration standard ci-dessus.

Alternativement, utilisez la commande slash /add-mcp dans l'invite Warp et collez la configuration standard ci-dessus :

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

Suivez la documentation Windsurf MCP. Utilisez la configuration standard ci-dessus.

{
  /**
   * 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;
  };

  /**
   * 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';
  };

  /**
   * 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' | 'none';
}

NOTE : L'implémentation Docker ne prend en charge que chromium headless pour le moment.

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

Ou si vous préférez exécuter le conteneur comme un service de longue durée au lieu de laisser le client MCP le lancer, utilisez :

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

Le serveur écoutera sur le port hôte 8931 et pourra être joint par n'importe quel client MCP.

Vous pouvez construire l'image Docker vous-même.

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);

  // ...
});

• Titre : Clic
• Description : Effectuer un clic sur une page web
• Paramètres :
  • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
  • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
  • doubleClick (booléen, optionnel) : S'il faut effectuer un double-clic au lieu d'un simple clic
  • button (chaîne, optionnel) : Bouton sur lequel cliquer, par défaut gauche
  • modifiers (tableau, optionnel) : Touches modificatrices à presser
• Lecture seule : false

• browser_close
  • Titre : Fermer le navigateur
  • Description : Fermer la page
  • Paramètres : Aucun
  • Lecture seule : false

• browser_console_messages
  • Titre : Obtenir les messages de la console
  • Description : Renvoie tous les messages de la console
  • Paramètres :
    • level (chaîne) : Niveau des messages de la console à renvoyer. Chaque niveau inclut les messages des niveaux plus sévères. Par défaut "info".
    • all (booléen, optionnel) : Renvoyer tous les messages de la console depuis le début de la session, pas seulement depuis la dernière navigation. Par défaut false.
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder les messages de la console. S'il n'est pas fourni, les messages sont renvoyés sous forme de texte.
  • Lecture seule : true

• browser_drag
  • Titre : Glisser la souris
  • Description : Effectuer un glisser-déposer entre deux éléments
  • Paramètres :
    • startElement (chaîne, optionnel) : Description lisible de l'élément source utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • startTarget (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • endElement (chaîne, optionnel) : Description lisible de l'élément cible utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • endTarget (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
  • Lecture seule : false

• browser_drop
  • Titre : Déposer des fichiers ou des données sur un élément
  • Description : Déposer des fichiers ou des données de type MIME sur un élément, comme s'ils étaient glissés depuis l'extérieur de la page. Au moins l'un des paramètres "paths" ou "data" doit être fourni.
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • paths (tableau, optionnel) : Chemins absolus des fichiers à déposer sur l'élément.
    • data (objet, optionnel) : Données à déposer, sous forme d'un dictionnaire de type MIME vers une valeur de chaîne (par exemple {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • Lecture seule : false

• browser_evaluate
  • Titre : Évaluer du JavaScript
  • Description : Évaluer une expression JavaScript sur la page ou un élément
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • target (chaîne, optionnel) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • function (chaîne) : () => { /* code / } ou (element) => { / code */ } lorsque l'élément est fourni
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder le résultat. S'il n'est pas fourni, le résultat est renvoyé sous forme de texte.
  • Lecture seule : false

• browser_file_upload
  • Titre : Téléverser des fichiers
  • Description : Téléverser un ou plusieurs fichiers
  • Paramètres :
    • paths (tableau, optionnel) : Les chemins absolus des fichiers à téléverser. Peut être un seul fichier ou plusieurs fichiers. S'il est omis, le sélecteur de fichier est annulé.
  • Lecture seule : false

• browser_fill_form
  • Titre : Remplir le formulaire
  • Description : Remplir plusieurs champs de formulaire
  • Paramètres :
    • fields (tableau) : Champs à remplir
  • Lecture seule : false

• browser_find
  • Titre : Rechercher dans l'instantané de la page
  • Description : Rechercher du texte ou une expression régulière dans l'instantané d'accessibilité de la page actuelle. Renvoie les nœuds d'instantané correspondants avec quelques lignes de contexte environnant (comme des extraits de recherche), chacun affiché sous son chemin depuis la racine de l'arborescence, ce qui est moins coûteux que de capturer l'instantané complet lorsque vous avez seulement besoin de localiser un élément et sa référence.
  • Paramètres :
    • text (chaîne, optionnel) : Texte brut à rechercher dans l'instantané de la page (correspondance de sous-chaîne insensible à la casse). Fournissez soit le texte, soit l'expression régulière, pas les deux.
    • regex (chaîne, optionnel) : Expression régulière à rechercher dans l'instantané de la page. La correspondance est sensible à la casse par défaut ; encadrez le motif de barres obliques pour ajouter des drapeaux, par exemple "/error/i" pour insensible à la casse. Fournissez soit le texte, soit l'expression régulière, pas les deux.
  • Lecture seule : true

• browser_handle_dialog
  • Titre : Gérer une boîte de dialogue
  • Description : Gérer une boîte de dialogue
  • Paramètres :
    • accept (booléen) : S'il faut accepter la boîte de dialogue.
    • promptText (chaîne, optionnel) : Le texte de l'invite dans le cas d'une boîte de dialogue de type prompt.
  • Lecture seule : false

• browser_hover
  • Titre : Survoler la souris
  • Description : Survoler un élément sur la page
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
  • Lecture seule : false

• browser_navigate
  • Titre : Naviguer vers une URL
  • Description : Naviguer vers une URL
  • Paramètres :
    • url (chaîne) : L'URL vers laquelle naviguer
  • Lecture seule : false

• browser_navigate_back
  • Titre : Revenir en arrière
  • Description : Revenir à la page précédente dans l'historique
  • Paramètres : Aucun
  • Lecture seule : false

• browser_network_request
  • Titre : Afficher les détails d'une requête réseau
  • Description : Renvoie les détails complets (en-têtes et corps) d'une seule requête réseau, ou d'une seule partie si part est défini. Utilisez le numéro de browser_network_requests.
  • Paramètres :
    • index (entier) : Index basé sur 1 de la requête, tel qu'affiché par browser_network_requests.
    • part (chaîne, optionnel) : Renvoyer uniquement cette partie de la requête. Omettre pour renvoyer les détails complets.
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder le résultat. S'il n'est pas fourni, la sortie est renvoyée sous forme de texte.
  • Lecture seule : true

• browser_network_requests
  • Titre : Lister les requêtes réseau
  • Description : Renvoie une liste numérotée des requêtes réseau depuis le chargement de la page. Utilisez browser_network_request avec le numéro pour obtenir les détails complets.
  • Paramètres :
    • static (booléen) : S'il faut inclure les ressources statiques réussies comme les images, les polices, les scripts, etc. Par défaut false.
    • filter (chaîne, optionnel) : Renvoyer uniquement les requêtes dont l'URL correspond à cette expression régulière (par exemple "/api/.*user").
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder les requêtes réseau. S'il n'est pas fourni, les requêtes sont renvoyées sous forme de texte.
  • Lecture seule : true

• browser_press_key
  • Titre : Appuyer sur une touche
  • Description : Appuyer sur une touche du clavier
  • Paramètres :
    • key (chaîne) : Nom de la touche à presser ou un caractère à générer, tel que ArrowLeft ou a
  • Lecture seule : false

• browser_resize
  • Titre : Redimensionner la fenêtre du navigateur
  • Description : Redimensionner la fenêtre du navigateur
  • Paramètres :
    • width (nombre) : Largeur de la fenêtre du navigateur
    • height (nombre) : Hauteur de la fenêtre du navigateur
  • Lecture seule : false

• browser_run_code_unsafe
  • Titre : Exécuter du code Playwright (non sécurisé)
  • Description : Exécuter un extrait de code Playwright. Non sécurisé : exécute du JavaScript arbitraire dans le processus du serveur Playwright et équivaut à une RCE.
  • Paramètres :
    • code (chaîne, optionnel) : Une fonction JavaScript contenant du code Playwright à exécuter. Elle sera invoquée avec un seul argument, page, que vous pouvez utiliser pour toute interaction avec la page. Par exemple : async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (chaîne, optionnel) : Charger le code depuis le fichier spécifié. Si les deux paramètres code et filename sont fournis, code sera ignoré.
  • Lecture seule : false

• browser_select_option
  • Titre : Sélectionner une option
  • Description : Sélectionner une option dans une liste déroulante
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • values (tableau) : Tableau des valeurs à sélectionner dans la liste déroulante. Cela peut être une valeur unique ou plusieurs valeurs.
  • Lecture seule : false

• browser_snapshot
  • Titre : Instantané de la page
  • Description : Capturer l'instantané d'accessibilité de la page actuelle, ceci est meilleur qu'une capture d'écran
  • Paramètres :
    • target (chaîne, optionnel) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • filename (chaîne, optionnel) : Sauvegarder l'instantané dans un fichier markdown au lieu de le renvoyer dans la réponse.
    • depth (nombre, optionnel) : Limiter la profondeur de l'arborescence de l'instantané
    • boxes (booléen, optionnel) : Inclure la boîte englobante de chaque élément sous la forme [box=x,y,width,height] dans l'instantané. Les coordonnées sont relatives à la fenêtre d'affichage, en pixels CSS (Element.getBoundingClientRect)
  • Lecture seule : true

• browser_take_screenshot
  • Titre : Prendre une capture d'écran
  • Description : Prendre une capture d'écran de la page actuelle. Vous ne pouvez pas effectuer d'actions basées sur la capture d'écran, utilisez browser_snapshot pour les actions.
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • target (chaîne, optionnel) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • type (chaîne) : Format d'image pour la capture d'écran. Par défaut png.
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder la capture d'écran. Par défaut page-{timestamp}.{png|jpeg} s'il n'est pas spécifié. Préférez les noms de fichiers relatifs pour rester dans le répertoire de sortie.
    • fullPage (booléen, optionnel) : Lorsque vrai, prend une capture d'écran de la page entière défilable, au lieu de la fenêtre d'affichage actuellement visible. Ne peut pas être utilisé avec les captures d'écran d'élément.
    • scale (chaîne) : Échelle de résolution de l'image. "css" produit une capture d'écran dimensionnée en pixels CSS (plus petite, cohérente entre les appareils). "device" produit une capture d'écran haute résolution utilisant les pixels de l'appareil (plus grande, tient compte du ratio de pixels de l'appareil). Par défaut css.
  • Lecture seule : true

• browser_type
  • Titre : Saisir du texte
  • Description : Saisir du texte dans un élément éditable
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir l'autorisation d'interagir avec l'élément
    • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
    • text (chaîne) : Texte à saisir dans l'élément
    • submit (booléen, optionnel) : S'il faut soumettre le texte saisi (appuyer sur Entrée après)
    • slowly (booléen, optionnel) : S'il faut saisir un caractère à la fois. Utile pour déclencher les gestionnaires de touches dans la page. Par défaut, tout le texte est rempli en une seule fois.
  • Lecture seule : false

• browser_wait_for
  • Titre : Attendre
  • Description : Attendre l'apparition ou la disparition d'un texte ou qu'un délai spécifié se soit écoulé
  • Paramètres :
    • time (nombre, optionnel) : Le temps d'attente en secondes
    • text (chaîne, optionnel) : Le texte à attendre
    • textGone (chaîne, optionnel) : Le texte dont il faut attendre la disparition
  • Lecture seule : false

• browser_tabs
  • Titre : Gérer les onglets
  • Description : Lister, créer, fermer ou sélectionner un onglet du navigateur.
  • Paramètres :
    • action (chaîne) : Opération à effectuer
    • index (nombre, optionnel) : Index de l'onglet, utilisé pour fermer/sélectionner. Si omis pour la fermeture, l'onglet actuel est fermé.
    • url (chaîne, optionnel) : URL vers laquelle naviguer dans le nouvel onglet, utilisé pour nouveau.
  • Lecture seule : false

• browser_get_config
  • Titre : Obtenir la configuration
  • Description : Obtenir la configuration finale résolue après fusion des options CLI, des variables d'environnement et du fichier de configuration.
  • Paramètres : Aucun
  • Lecture seule : true

• browser_network_state_set
  • Titre : Définir l'état du réseau
  • Description : Définit l'état du réseau du navigateur sur en ligne ou hors ligne. Lorsqu'il est hors ligne, toutes les requêtes réseau échoueront.
  • Paramètres :
    • state (chaîne) : Définir sur "offline" pour simuler le mode hors ligne, "online" pour restaurer la connectivité réseau
  • Lecture seule : false

• browser_route
  • Titre : Simuler des requêtes réseau
  • Description : Configurer une route pour simuler des requêtes réseau correspondant à un modèle d'URL
  • Paramètres :
    • pattern (chaîne) : Modèle d'URL à faire correspondre (par exemple, "/api/users", "/*.{png,jpg}")
    • status (nombre, optionnel) : Code de statut HTTP à retourner (par défaut : 200)
    • body (chaîne, optionnel) : Corps de la réponse (texte ou chaîne JSON)
    • contentType (chaîne, optionnel) : En-tête Content-Type (par exemple, "application/json", "text/html")
    • headers (tableau, optionnel) : En-têtes à ajouter au format "Nom : Valeur"
    • removeHeaders (chaîne, optionnel) : Liste séparée par des virgules des noms d'en-têtes à supprimer de la requête
  • Lecture seule : false

• browser_route_list
  • Titre : Lister les routes réseau
  • Description : Lister toutes les routes réseau actives
  • Paramètres : Aucun
  • Lecture seule : true

• browser_unroute
  • Titre : Supprimer des routes réseau
  • Description : Supprimer les routes réseau correspondant à un modèle (ou toutes les routes si aucun modèle n'est spécifié)
  • Paramètres :
    • pattern (chaîne, optionnel) : Modèle d'URL à supprimer (omettre pour supprimer toutes les routes)
  • Lecture seule : false

• browser_cookie_clear
  • Titre : Effacer les cookies
  • Description : Effacer tous les cookies
  • Paramètres : Aucun
  • Lecture seule : false

• browser_cookie_delete
  • Titre : Supprimer un cookie
  • Description : Supprimer un cookie spécifique
  • Paramètres :
    • name (chaîne) : Nom du cookie à supprimer
  • Lecture seule : false

• browser_cookie_get
  • Titre : Obtenir un cookie
  • Description : Obtenir un cookie spécifique par son nom
  • Paramètres :
    • name (chaîne) : Nom du cookie à obtenir
  • Lecture seule : true

• browser_cookie_list
  • Titre : Lister les cookies
  • Description : Lister tous les cookies (éventuellement filtrés par domaine/chemin)
  • Paramètres :
    • domain (chaîne, optionnel) : Filtrer les cookies par domaine
    • path (chaîne, optionnel) : Filtrer les cookies par chemin
  • Lecture seule : true

• browser_cookie_set
  • Titre : Définir un cookie
  • Description : Définir un cookie avec des indicateurs optionnels (domaine, chemin, expiration, httpOnly, secure, sameSite)
  • Paramètres :
    • name (chaîne) : Nom du cookie
    • value (chaîne) : Valeur du cookie
    • domain (chaîne, optionnel) : Domaine du cookie
    • path (chaîne, optionnel) : Chemin du cookie
    • expires (nombre, optionnel) : Expiration du cookie en tant que timestamp Unix
    • httpOnly (booléen, optionnel) : Si le cookie est HTTP only
    • secure (booléen, optionnel) : Si le cookie est sécurisé
    • sameSite (chaîne, optionnel) : Attribut SameSite du cookie
  • Lecture seule : false

• browser_localstorage_clear
  • Titre : Effacer le localStorage
  • Description : Effacer tout le localStorage
  • Paramètres : Aucun
  • Lecture seule : false

• browser_localstorage_delete
  • Titre : Supprimer un élément du localStorage
  • Description : Supprimer un élément du localStorage
  • Paramètres :
    • key (chaîne) : Clé à supprimer
  • Lecture seule : false

• browser_localstorage_get
  • Titre : Obtenir un élément du localStorage
  • Description : Obtenir un élément du localStorage par sa clé
  • Paramètres :
    • key (chaîne) : Clé à obtenir
  • Lecture seule : true

• browser_localstorage_list
  • Titre : Lister le localStorage
  • Description : Lister toutes les paires clé-valeur du localStorage
  • Paramètres : Aucun
  • Lecture seule : true

• browser_localstorage_set
  • Titre : Définir un élément du localStorage
  • Description : Définir un élément du localStorage
  • Paramètres :
    • key (chaîne) : Clé à définir
    • value (chaîne) : Valeur à définir
  • Lecture seule : false

• browser_sessionstorage_clear
  • Titre : Effacer le sessionStorage
  • Description : Effacer tout le sessionStorage
  • Paramètres : Aucun
  • Lecture seule : false

• browser_sessionstorage_delete
  • Titre : Supprimer un élément du sessionStorage
  • Description : Supprimer un élément du sessionStorage
  • Paramètres :
    • key (chaîne) : Clé à supprimer
  • Lecture seule : false

• browser_sessionstorage_get
  • Titre : Obtenir un élément du sessionStorage
  • Description : Obtenir un élément du sessionStorage par sa clé
  • Paramètres :
    • key (chaîne) : Clé à obtenir
  • Lecture seule : true

• browser_sessionstorage_list
  • Titre : Lister le sessionStorage
  • Description : Lister toutes les paires clé-valeur du sessionStorage
  • Paramètres : Aucun
  • Lecture seule : true

• browser_sessionstorage_set
  • Titre : Définir un élément du sessionStorage
  • Description : Définir un élément du sessionStorage
  • Paramètres :
    • key (chaîne) : Clé à définir
    • value (chaîne) : Valeur à définir
  • Lecture seule : false

• browser_set_storage_state
  • Titre : Restaurer l'état du stockage
  • Description : Restaurer l'état du stockage (cookies, stockage local) à partir d'un fichier. Cela efface les cookies et le stockage local existants avant la restauration.
  • Paramètres :
    • filename (chaîne) : Chemin vers le fichier d'état de stockage à partir duquel restaurer
  • Lecture seule : false

• browser_storage_state
  • Titre : Sauvegarder l'état du stockage
  • Description : Sauvegarder l'état du stockage (cookies, stockage local) dans un fichier pour une réutilisation ultérieure
  • Paramètres :
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder l'état du stockage. Par défaut storage-state-{timestamp}.json si non spécifié.
  • Lecture seule : true

• browser_annotate
  • Titre : Annoter la page actuelle
  • Description : Ouvrir le tableau de bord Playwright en mode annotation pour la page actuelle et attendre que l'utilisateur dessine des annotations. Retourne la capture d'écran annotée, l'instantané ARIA et la liste des annotations.
  • Paramètres : Aucun
  • Lecture seule : true

• browser_hide_highlight
  • Titre : Masquer la surbrillance d'élément
  • Description : Supprimer une superposition de surbrillance précédemment ajoutée pour l'élément.
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée lors de l'ajout de la surbrillance ; doit correspondre à la valeur passée à browser_highlight.
    • target (chaîne, optionnel) : Référence exacte de l'élément cible à partir de l'instantané de la page, ou un sélecteur d'élément unique
  • Lecture seule : true

• browser_highlight
  • Titre : Surbrillance d'élément
  • Description : Afficher une superposition de surbrillance persistante autour de l'élément sur la page.
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir la permission d'interagir avec l'élément
    • target (chaîne) : Référence exacte de l'élément cible à partir de l'instantané de la page, ou un sélecteur d'élément unique
    • style (chaîne, optionnel) : CSS en ligne supplémentaire appliqué à la superposition de surbrillance, par exemple "outline: 2px dashed red".
  • Lecture seule : true

• browser_resume
  • Titre : Reprendre l'exécution du script en pause
  • Description : Reprendre l'exécution du script après sa mise en pause. Lorsqu'il est appelé avec step défini sur true, l'exécution se mettra à nouveau en pause avant l'action suivante.
  • Paramètres :
    • step (booléen, optionnel) : Lorsque true, l'exécution se mettra à nouveau en pause avant l'action suivante, permettant un débogage pas à pas.
    • location (chaîne, optionnel) : Mettre en pause l'exécution à un : spécifique, par exemple "example.spec.ts:42".
  • Lecture seule : false

• browser_start_tracing
  • Titre : Démarrer le traçage
  • Description : Démarrer l'enregistrement de la trace
  • Paramètres : Aucun
  • Lecture seule : true

• browser_start_video
  • Titre : Démarrer la vidéo
  • Description : Démarrer l'enregistrement vidéo
  • Paramètres :
    • filename (chaîne, optionnel) : Nom du fichier pour sauvegarder la vidéo.
    • size (objet, optionnel) : Taille de la vidéo
  • Lecture seule : true

• browser_stop_tracing
  • Titre : Arrêter le traçage
  • Description : Arrêter l'enregistrement de la trace
  • Paramètres : Aucun
  • Lecture seule : true

• browser_stop_video
  • Titre : Arrêter la vidéo
  • Description : Arrêter l'enregistrement vidéo
  • Paramètres : Aucun
  • Lecture seule : true

• browser_video_chapter
  • Titre : Chapitre vidéo
  • Description : Ajouter un marqueur de chapitre à l'enregistrement vidéo. Affiche une carte de chapitre en plein écran avec un arrière-plan flouté.
  • Paramètres :
    • title (chaîne) : Titre du chapitre
    • description (chaîne, optionnel) : Description du chapitre
    • duration (nombre, optionnel) : Durée en millisecondes pour afficher la carte de chapitre
  • Lecture seule : true

• browser_video_hide_actions
  • Titre : Masquer les superpositions d'actions
  • Description : Arrêter d'annoter les actions effectuées sur la page.
  • Paramètres : Aucun
  • Lecture seule : true

• browser_video_show_actions
  • Titre : Afficher les superpositions d'actions
  • Description : Annoter les actions suivantes effectuées sur la page avec une légende qui nomme l'action et met en surbrillance l'élément cible. Utile pendant l'enregistrement vidéo ou la diffusion d'écran.
  • Paramètres :
    • duration (nombre, optionnel) : Durée d'affichage de chaque annotation d'action à l'écran, en millisecondes. Par défaut 500.
    • position (chaîne, optionnel) : Où placer le titre de l'action par rapport à la page. Par défaut en haut à droite.
    • cursor (chaîne, optionnel) : Décoration du curseur pour les actions de pointeur. "pointer" (par défaut) anime un pointeur de souris du point d'action précédent au suivant ; "none" désactive la décoration du curseur.
  • Lecture seule : true

• browser_mouse_click_xy
  • Titre : Clic
  • Description : Cliquer avec le bouton de la souris à une position donnée
  • Paramètres :
    • x (nombre) : Coordonnée X
    • y (nombre) : Coordonnée Y
    • button (chaîne, optionnel) : Bouton sur lequel cliquer, par défaut gauche
    • clickCount (nombre, optionnel) : Nombre de clics, par défaut 1
    • delay (nombre, optionnel) : Temps d'attente entre l'appui et le relâchement du bouton de la souris en millisecondes, par défaut 0
  • Lecture seule : false

• browser_mouse_down
  • Titre : Appuyer sur le bouton de la souris
  • Description : Appuyer sur le bouton de la souris
  • Paramètres :
    • button (chaîne, optionnel) : Bouton sur lequel appuyer, par défaut gauche
  • Lecture seule : false

• browser_mouse_drag_xy
  • Titre : Faire glisser la souris
  • Description : Faire glisser le bouton gauche de la souris jusqu'à une position donnée
  • Paramètres :
    • startX (nombre) : Coordonnée X de départ
    • startY (nombre) : Coordonnée Y de départ
    • endX (nombre) : Coordonnée X d'arrivée
    • endY (nombre) : Coordonnée Y d'arrivée
  • Lecture seule : false

• browser_mouse_move_xy
  • Titre : Déplacer la souris
  • Description : Déplacer la souris à une position donnée
  • Paramètres :
    • x (nombre) : Coordonnée X
    • y (nombre) : Coordonnée Y
  • Lecture seule : false

• browser_mouse_up
  • Titre : Relâcher le bouton de la souris
  • Description : Relâcher le bouton de la souris
  • Paramètres :
    • button (chaîne, optionnel) : Bouton à relâcher, par défaut gauche
  • Lecture seule : false

• browser_mouse_wheel
  • Titre : Faire défiler la molette de la souris
  • Description : Faire défiler la molette de la souris
  • Paramètres :
    • deltaX (nombre) : Delta X
    • deltaY (nombre) : Delta Y
  • Lecture seule : false

• browser_pdf_save
  • Titre : Enregistrer en PDF
  • Description : Enregistrer la page en PDF
  • Paramètres :
    • filename (chaîne, optionnel) : Nom du fichier pour enregistrer le PDF. Par défaut page-{timestamp}.pdf si non spécifié. Préférer les noms de fichiers relatifs pour rester dans le répertoire de sortie.
  • Lecture seule : true

• browser_generate_locator
  • Titre : Créer un localisateur pour l'élément
  • Description : Générer un localisateur pour l'élément donné à utiliser dans les tests
  • Paramètres :
    • element (chaîne, optionnel) : Description lisible de l'élément utilisée pour obtenir la permission d'interagir avec l'élément
    • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page, ou un sélecteur d'élément unique
  • Lecture seule : true

• browser_verify_element_visible
  • Titre : Vérifier que l'élément est visible
  • Description : Vérifier que l'élément est visible sur la page
  • Paramètres :
    • role (chaîne) : RÔLE de l'élément. Peut être trouvé dans l'instantané comme ceci : - {ROLE} "Accessible Name":
    • accessibleName (chaîne) : NOM_ACCESSIBLE de l'élément. Peut être trouvé dans l'instantané comme ceci : - role "{ACCESSIBLE_NAME}"
  • Lecture seule : false

• browser_verify_list_visible
  • Titre : Vérifier que la liste est visible
  • Description : Vérifier que la liste est visible sur la page
  • Paramètres :
    • element (chaîne) : Description lisible de la liste
    • target (chaîne) : Référence exacte de l'élément cible qui pointe vers la liste
    • items (tableau) : Éléments à vérifier
  • Lecture seule : false

• browser_verify_text_visible
  • Titre : Vérifier que le texte est visible
  • Description : Vérifier que le texte est visible sur la page. Préférer browser_verify_element_visible si possible.
  • Paramètres :
    • text (chaîne) : TEXTE à vérifier. Peut être trouvé dans l'instantané comme ceci : - role "Accessible Name": {TEXT} ou comme ceci : - text: {TEXT}
  • Lecture seule : false

• browser_verify_value
  • Titre : Vérifier la valeur
  • Description : Vérifier la valeur de l'élément
  • Paramètres :
    • type (chaîne) : Type de l'élément
    • element (chaîne) : Description lisible de l'élément
    • target (chaîne) : Référence exacte de l'élément cible depuis l'instantané de la page
    • value (chaîne) : Valeur à vérifier. Pour une case à cocher, utiliser "true" ou "false".
  • Lecture seule : false