Installer d’abord le CLI Playwright pour un agent de code, puis parler d’échafaudage de tests

À qui cela s’adresse

Cette compétence convient à qui veut une même API pour piloter Chromium, Firefox et WebKit. Officiellement c’est un cadre d’automatisation web et de tests, utilisable pour tests, scripts, et comme outil d’agents de code. Elle convient aussi à qui utilise déjà des agents comme Claude Code ou Copilot et s’apprête à installer la ligne de commande officielle. Ces deux noms viennent d’exemples du texte source ; ne les lisez pas comme les seuls outils pris en charge.

Elle ne convient pas à qui n’a pas accepté une installation globale mais veut tout de suite un projet de tests entier. Officiellement il y a aussi npm init playwright@latest, qui initialise un projet de tests ; ne prenez pas ce chemin la première fois. Si vous voulez d’abord que l’agent sache utiliser la ligne de commande, le chemin principal est l’installation globale de @playwright/cli.

Le dépôt officiel est https://github.com/microsoft/playwright Opérez avec les commandes déjà écrites sur cette page.

Première tentative en 3 minutes

Ne suivez que ce chemin d’install que la page officielle écrit pour les agents de code.

Préalable : cette machine peut exécuter npm, et vous acceptez clairement une installation globale. Confirmez d’abord : npm i -g @playwright/cli@latest installe la ligne de commande en global. Si vous ne voulez pas encore changer les paquets globaux, ne l’exécutez pas. À cette étape, n’initialisez pas un projet de tests et n’ouvrez pas un site réel.

Emplacement d’installation : dans n’importe quel terminal, confirmez les effets de bord, puis :

npm i -g @playwright/cli@latest

Contrôle à faible risque : après l’install, faites d’abord à l’agent seulement reformuler l’usage de ce CLI d’après les notes officielles — il est écrit comme ligne de commande d’automatisation navigateur pour agents de code, plus économe en token que MCP, et les commandes évitent de charger de grands schémas d’outils et des arbres d’accessibilité dans le contexte du modèle. Ne démarrez pas de navigateur. N’envoyez pas de requêtes vers un site externe. Si vous voulez plus tard une intégration d’agent plus complète, le texte source a aussi playwright-cli install --skills ; cela écrit des fichiers de compétence, confirmez encore avant d’exécuter.

Signal de réussite : l’install globale est finie, l’agent peut indiquer que la commande principale est @playwright/cli, et il n’a pas basculé vers un installeur absent. S’il lance npm init playwright@latest directement, le chemin est faux ; arrêtez.

Cas d’usage

Cas 1 : installer le CLI officiel pour un agent de code. À côté de Claude Code et Copilot, le texte source écrit npm i -g @playwright/cli@latest, puis vous pouvez utiliser playwright-cli install --skills pour une intégration d’agent plus riche. Convient à qui veut d’abord la ligne de commande et décidera plus tard d’écrire des fichiers de compétence. La deuxième commande change le répertoire local de compétences ; confirmez avant d’exécuter.

Cas 2 : créer un nouveau projet de tests de bout en bout. La commande officielle est npm init playwright@latest. Convient à qui a déjà décidé vouloir un échafaudage de tests et accepte qu’il crée des fichiers de projet. L’init écrit sur le disque ; ne l’exécutez pas tant que vous voulez seulement essayer la ligne de commande. Si le texte source n’écrit pas d’interrupteur de téléchargement de navigateurs, n’inventez pas de drapeaux.

Limites d’usage

Le chemin principal est npm i -g @playwright/cli@latest. N’écrivez pas un installeur absent dans le chemin principal. playwright-cli install --skills et npm init playwright@latest sont deux autres commandes du texte source, à usages différents ; ne les fusionnez pas.

La couverture est de piloter Chromium, Firefox et WebKit avec la même API, pour tests, scripts et agents de code. Elle ne prouve pas qu’on puisse piloter un moteur de navigateur non nommé. Claude Code et Copilot ne sont qu’une liste d’exemples.

La page officielle est https://github.com/microsoft/playwright Si la première commande proposée par l’agent n’est pas l’installation globale de @playwright/cli, cette page prime. Ne pas automatiser un site de production à la première tentative.