Playwright MCP

Ajoutez via l'écran des paramètres de l'extension Amp VS Code 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 le 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 dans 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 le 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 MCP de Codex.

Utilisez le 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-le à 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 le CLI Factory pour ajouter le serveur Playwright MCP :

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

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

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

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-le à votre convenance, utilisez le type STDIO, et définissez le command sur npx @playwright/mcp. Cliquez sur "Add Extension".

Utilisez le 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 MCP de Grok.

Pour ajouter le serveur Playwright MCP dans Junie CLI :

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 MCP de Junie.

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 → Connect more tools → + Add new 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 le 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 MCP de Windsurf. 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;

  /**
   * Whether to collect and expose the tools that a page registers through the
   * experimental WebMCP API. Enabled by default.
   */
  webmcp?: 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 for automatically named output files, for example a screenshot taken without an
   * explicit file name. Files with an explicit name are resolved against the workspace root instead
   * and are not affected by this option.
   */
  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;

    /**
     * Close the browser after this many milliseconds without a tool call, and relaunch it on the next one.
     * Defaults to one hour for headless browsers Playwright launched, and to no timeout for headed or attached ones. Pass 0 to disable.
     * The CLI shuts the whole session down instead of relaunching.
     */
    idle?: number;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "only". Defaults to "allow".
   * With "only", a response that carries an image consists of the image parts alone, without the text part.
   */
  imageResponses?: 'allow' | 'omit' | 'only';

  /**
   * How file paths are rendered in tool results. Can be "relative" to the workspace root or "absolute". Defaults to "relative".
   */
  filePaths?: 'relative' | 'absolute';

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

REMARQUE : L'implémentation Docker ne prend actuellement en charge que chromium en mode headless.

{
  "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 à long terme plutôt que 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 atteint 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);

  // ...
});

• browser_click
  • Titre : Cliquer
  • Description : Effectuer un clic sur une page web
  • 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
    • doubleClick (booléen, optionnel) : Indique si un double-clic doit être effectué au lieu d'un simple clic
    • button (chaîne, optionnel) : Bouton à cliquer, par défaut le bouton 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 dans lequel enregistrer les messages de la console. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. 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 la permission 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 la permission 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 typées 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 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
    • paths (tableau, optionnel) : Chemins absolus des fichiers à déposer sur l'élément.
    • data (objet, optionnel) : Données à déposer, sous forme de correspondance entre le type MIME et la valeur de chaîne (par exemple {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • Lecture seule : false

• browser_emulate_media
  • Titre : Émuler les fonctionnalités média
  • Description : Émuler les fonctionnalités média CSS de la page, par exemple basculer entre le schéma de couleurs clair et sombre. Les paramètres omis restent inchangés ; null efface une surcharge.
  • Paramètres :
    • colorScheme (optionnel) : Émule la fonctionnalité média prefers-color-scheme
    • reducedMotion (optionnel) : Émule la fonctionnalité média prefers-reduced-motion
    • forcedColors (optionnel) : Émule la fonctionnalité média forced-colors
    • contrast (optionnel) : Émule la fonctionnalité média prefers-contrast
    • media (optionnel) : Modifie le type de média CSS de la page
  • 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 la permission 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 */ } lorsqu'un élément est fourni
    • filename (chaîne, optionnel) : Nom du fichier dans lequel enregistrer le résultat. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. 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) : Chemins absolus des fichiers à téléverser. Peut être un seul fichier ou plusieurs fichiers. S'il est omis, le sélecteur de fichiers 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 tout l'instantané 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 du texte, soit une 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 avec des barres obliques pour ajouter des indicateurs, par exemple "/error/i" pour insensible à la casse. Fournissez soit du texte, soit une expression régulière, pas les deux.
    • filename (chaîne, optionnel) : Enregistrer les résultats dans un fichier au lieu de les renvoyer dans la réponse. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail.
  • 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) : Indique si la boîte de dialogue doit être acceptée.
    • promptText (chaîne, optionnel) : Le texte de l'invite dans le cas d'une boîte de dialogue d'invite.
  • Lecture seule : false

• browser_hover
  • Titre : Survolez la souris
  • Description : Survolez un é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 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 de la requête réseau
  • Description : Renvoie les détails complets (en-têtes et corps) d'une seule requête réseau, ou 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 dans lequel enregistrer le résultat. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. 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) : Indique 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 dans lequel enregistrer les requêtes réseau. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. S'il n'est pas fourni, les requêtes sont renvoyées sous forme de texte.
  • Lecture seule : true

• browser_press_key
  • Titre : Presser une touche
  • Description : Presser une touche du clavier
  • Paramètres :
    • key (chaîne) : Nom de la touche à presser ou caractère à générer, comme 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 serveur Playwright et équivaut à une exécution de code à distance (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é. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. Si le code et le nom de fichier sont tous deux fournis, le 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 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
    • values (tableau) : Tableau de valeurs à sélectionner dans la liste déroulante. Cela peut être une seule valeur ou plusieurs valeurs.
  • Lecture seule : false

• browser_snapshot
  • Titre : Capture instantanée de la page
  • Description : Capture une capture instantanée d'accessibilité de la page actuelle, c'est mieux qu'une capture d'écran
  • Paramètres :
    • target (chaîne, facultatif) : Référence exacte de l'élément cible depuis la capture instantanée de la page, ou un sélecteur d'élément unique
    • filename (chaîne, facultatif) : Enregistrer la capture instantanée dans un fichier au lieu de la renvoyer dans la réponse. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail.
    • depth (nombre, facultatif) : Limiter la profondeur de l'arborescence de la capture instantanée
    • boxes (booléen, facultatif) : Inclure la boîte englobante de chaque élément sous la forme [box=x,y,largeur,hauteur] dans la capture instantanée. 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, facultatif) : Description lisible de l'élément utilisée pour obtenir la permission d'interagir avec l'élément
    • target (chaîne, facultatif) : Référence exacte de l'élément cible depuis la capture instantanée de la page, ou un sélecteur d'élément unique
    • type (chaîne, facultatif) : Format d'image pour la capture d'écran. Si non défini, déduit de l'extension du nom de fichier, sinon png.
    • filename (chaîne, facultatif) : Nom de fichier pour enregistrer la capture d'écran. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. Si non spécifié, la capture d'écran est enregistrée dans le répertoire de sortie sous le nom page-{timestamp}.{png|jpeg|webp}.
    • fullPage (booléen, facultatif) : Lorsque true, prend une capture d'écran de la page défilante complète, au lieu de la fenêtre d'affichage actuellement visible. Ne peut pas être utilisé avec les captures d'écran d'éléments.
    • 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). La valeur par défaut est css.
  • Lecture seule : true

• browser_type
  • Titre : Saisir du texte
  • Description : Saisir du texte dans un élément éditable
  • Paramètres :
    • element (chaîne, facultatif) : 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 la capture instantanée de la page, ou un sélecteur d'élément unique
    • text (chaîne) : Texte à saisir dans l'élément
    • submit (booléen, facultatif) : Indique si le texte saisi doit être soumis (appuyer sur Entrée après)
    • slowly (booléen, facultatif) : Indique si le texte doit être saisi 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 temps spécifié se soit écoulé
  • Paramètres :
    • time (nombre, facultatif) : Le temps d'attente en secondes, au maximum 30
    • text (chaîne, facultatif) : Le texte à attendre
    • textGone (chaîne, facultatif) : Le texte à attendre pour qu'il disparaisse
  • 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, facultatif) : Index de l'onglet, utilisé pour fermer/sélectionner. Si omis pour fermer, l'onglet actuel est fermé.
    • url (chaîne, facultatif) : 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 les requêtes réseau
  • Description : Configurer une route pour simuler les 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, facultatif) : Code de statut HTTP à renvoyer (par défaut : 200)
    • body (chaîne, facultatif) : Corps de la réponse (texte ou chaîne JSON)
    • contentType (chaîne, facultatif) : En-tête Content-Type (par exemple, "application/json", "text/html")
    • headers (tableau, facultatif) : En-têtes à ajouter au format "Nom : Valeur"
    • removeHeaders (chaîne, facultatif) : 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 les 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, facultatif) : 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, facultatif) : Filtrer les cookies par domaine
    • path (chaîne, facultatif) : Filtrer les cookies par chemin
  • Lecture seule : true

• browser_cookie_set
  • Titre : Définir un cookie
  • Description : Définir un cookie avec des indicateurs facultatifs (domaine, chemin, expiration, httpOnly, secure, sameSite)
  • Paramètres :
    • name (chaîne) : Nom du cookie
    • value (chaîne) : Valeur du cookie
    • domain (chaîne, facultatif) : Domaine du cookie
    • path (chaîne, facultatif) : Chemin du cookie
    • expires (nombre, facultatif) : Expiration du cookie en tant qu'horodatage Unix
    • httpOnly (booléen, facultatif) : Indique si le cookie est HTTP uniquement
    • secure (booléen, facultatif) : Indique si le cookie est sécurisé
    • sameSite (chaîne, facultatif) : Attribut SameSite du cookie
  • Lecture seule : false

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

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

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

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

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

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

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

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

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

• browser_sessionstorage_set
  • Titre : Définir un élément sessionStorage
  • Description : Définir un élément 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 du stockage à restaurer. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail.
  • Lecture seule : false

• browser_storage_state
  • Titre : Enregistrer l'état du stockage
  • Description : Enregistrer l'état du stockage (cookies, stockage local) dans un fichier pour une réutilisation ultérieure
  • Paramètres :
    • filename (chaîne, facultatif) : Nom de fichier pour enregistrer l'état du stockage. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. Si non spécifié, l'état du stockage est enregistré dans le répertoire de sortie sous le nom storage-state-{timestamp}.json.
  • 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. Renvoie la capture d'écran annotée, la capture instantanée ARIA et la liste des annotations.
  • Paramètres : Aucun
  • Lecture seule : true

• browser_hide_highlight
  • Titre : Masquer la surbrillance de l'élément
  • Description : Supprimer une superposition de surbrillance précédemment ajoutée pour l'élément.
  • Paramètres :
    • element (chaîne, facultatif) : 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, facultatif) : Référence exacte de l'élément cible depuis la capture instantanée de la page, ou un sélecteur d'élément unique
  • Lecture seule : true

• browser_highlight
  • Titre : Mettre en surbrillance l'élément
  • Description : Afficher une superposition de surbrillance persistante autour de l'élément sur la page.
  • Paramètres :
    • element (chaîne, facultatif) : 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 à partir de l'instantané de la page, ou sélecteur d'élément unique
    • style (chaîne, facultatif) : 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, facultatif) : Lorsqu'il est défini sur true, l'exécution se mettra à nouveau en pause avant l'action suivante, permettant un débogage pas à pas.
    • location (chaîne, facultatif) : Mettre l'exécution en pause à un : spécifique, par exemple « example.spec.ts:42 ».
  • Lecture seule : false

• browser_start_recording
  • Titre : Démarrer l'enregistrement des actions utilisateur
  • Description : Démarrer l'enregistrement des actions que l'utilisateur effectue dans le navigateur sous forme de code Playwright. Utilisez-le lorsque l'utilisateur souhaite démontrer un flux manuellement. Appelez browser_stop_recording lorsque l'utilisateur indique avoir terminé pour récupérer les actions enregistrées.
  • Paramètres : Aucun
  • Lecture seule : true

• 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, facultatif) : Nom du fichier dans lequel enregistrer la vidéo. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. S'il n'est pas spécifié, la vidéo est enregistrée dans le répertoire de sortie sous le nom video-{timestamp}.webm.
    • size (objet, facultatif) : Taille de la vidéo
    • fps (nombre, facultatif) : Fréquence d'images de la vidéo en images par seconde, par défaut 25
    • cursor (booléen, facultatif) : Afficher un curseur de souris animé qui se déplace vers chaque point d'action. Espace les actions de 800 ms afin que le curseur ait le temps de se déplacer.
  • Lecture seule : true

• browser_stop_recording
  • Titre : Arrêter l'enregistrement des actions utilisateur
  • Description : Arrêter l'enregistrement démarré avec browser_start_recording et renvoyer les actions enregistrées sous forme de code Playwright.
  • Paramètres : Aucun
  • 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, facultatif) : Description du chapitre
    • duration (nombre, facultatif) : Durée en millisecondes pendant laquelle afficher la carte de chapitre
  • Lecture seule : true

• browser_video_hide_actions
  • Titre : Masquer les superpositions d'actions
  • Description : Cesser 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 ultérieures effectuées sur la page avec une étiquette qui nomme l'action et, lorsqu'elle est stylisée, marque le point d'action et met en surbrillance l'élément cible. Utile lors de l'enregistrement vidéo ou de la diffusion d'écran.
  • Paramètres :
    • duration (nombre, facultatif) : Durée d'affichage de chaque annotation d'action à l'écran, en millisecondes. Par défaut 500.
    • position (chaîne, facultatif) : Emplacement du titre de l'action par rapport à la page. Par défaut en haut à droite.
    • cursor (chaîne, facultatif) : Décoration du curseur pour les actions de pointage. « 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.
    • style (objet, facultatif) : Styles des décorations d'actions.
  • Lecture seule : true

• browser_mouse_click_xy
  • Titre : Cliquer
  • 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, facultatif) : Bouton à cliquer, par défaut gauche
    • clickCount (nombre, facultatif) : Nombre de clics, par défaut 1
    • delay (nombre, facultatif) : Temps d'attente entre l'enfoncement et le relâchement de la souris en millisecondes, par défaut 0
  • Lecture seule : false

• browser_mouse_down
  • Titre : Enfoncer le bouton de la souris
  • Description : Enfoncer le bouton de la souris
  • Paramètres :
    • button (chaîne, facultatif) : Bouton à enfoncer, 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 vers 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 de fin
    • endY (nombre) : Coordonnée Y de fin
  • Lecture seule : false

• browser_mouse_move_xy
  • Titre : Déplacer la souris
  • Description : Déplacer la souris vers 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, facultatif) : 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 au format PDF
  • Description : Enregistrer la page au format PDF
  • Paramètres :
    • filename (chaîne, facultatif) : Nom du fichier dans lequel enregistrer le PDF. Les noms de fichiers relatifs sont résolus par rapport à la racine de l'espace de travail. S'il n'est pas spécifié, le PDF est enregistré dans le répertoire de sortie sous le nom page-{timestamp}.pdf.
  • 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, facultatif) : 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 à partir de l'instantané de la page, ou 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érez 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 à partir de l'instantané de la page
    • value (chaîne) : Valeur à vérifier. Pour une case à cocher, utilisez « true » ou « false ».
  • Lecture seule : false