Console Playwright : messages absents
Messages de console Playwright absents ? Distinguez stdout de Node et exceptions de page ; abonnez-vous tôt et consultez l’historique limité.
BotBrowser Team
Vous voulez la documentation structurée pour Démarrage ?
Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.
Lorsque des messages de console Playwright manquent, vérifiez où le message a été émis et quand le listener a commencé à écouter. Un console.log() dans le test Node s’exécute dans un environnement différent de celui de la page, tandis qu’une exception non interceptée dans la page possède son propre événement. BotBrowser permet à Playwright de contrôler son exécutable de navigateur ; il ne modifie pas la séparation entre ces canaux de sortie et ne fait pas recevoir les anciens messages à un listener tardif.
Résumé
- Abonnez-vous à
page.on('console')avant la navigation ou l’action qui produit le message du navigateur. Affichez explicitement le message reçu s’il doit apparaître dans le terminal. - Abonnez-vous séparément à
page.on('pageerror')pour les exceptions non interceptées de la page. Unconsole.error()du navigateur est un message de console de typeerror. - Le
console.log()de Node écrit sur stdout du processus qui exécute le test. Sa présence ne prouve pas qu’un listener de page fonctionne. - Depuis Playwright v1.56,
page.consoleMessages()etpage.pageErrors()donnent accès à un historique récent limité. Sa lecture ne renvoie pas les événements à un listener nouvellement enregistré.
Sommaire
- Identifier le canal de sortie avant de modifier le test
- Enregistrer les listeners avant l’opération déclenchante
- Comparer les listeners précoces et tardifs sur une page contrôlée
- Lire l’historique récent sans supposer un journal complet
- Distinguer le type, les arguments et l’emplacement du message
- Diagnostiquer un listener silencieux sans masquer les défaillances
- Conclusion pratique
Identifier le canal de sortie avant de modifier le test
Le mot console peut désigner le processus Node qui exécute le test, les outils de développement du navigateur ou un ConsoleMessage de Playwright transmis à une fonction de rappel. L’écriture commune console.log() ne rend pas ces destinations interchangeables. Partez de la ligne qui produit le texte absent : déterminez si elle s’exécute directement dans le fichier de test, dans page.evaluate() ou dans un script applicatif chargé par la page.
Selon la documentation de la console Node, la console globale envoie la sortie normale sur stdout et les erreurs sur stderr. Ainsi, console.log('NODE_DRIVER_ONLY') placé directement dans un script de test CommonJS produit une sortie du processus de test. Un listener de console de page ne la reçoit pas. Un système de CI peut afficher ou capturer ce flux indépendamment de ce que Playwright observe dans le navigateur.
À l’inverse, await page.evaluate(() => console.log('PAGE_LOG')) exécute l’appel de journalisation dans le navigateur. L’événement console de Page de Playwright expose les appels à l’API console de la page. Pour transférer cet événement vers la sortie Node, ajoutez un gestionnaire qui appelle la console Node ou enregistre les données choisies dans un artefact. Un listener qui remplit uniquement un tableau n’affiche pas automatiquement ce tableau dans le terminal.
Une exception de script non interceptée constitue un troisième signal. L’événement pageerror de Page signale les exceptions non interceptées dans la page. Un appel tel que console.error('PAGE_CONSOLE_ERROR') journalise un message de niveau erreur sans lever d’exception. Réciproquement, un script peut lever une exception sans appeler d’abord console.error(). Capturez les deux types d’événements lorsqu’une application risque de s’arrêter au démarrage.
Cette distinction affecte le verdict du test autant que la visibilité. Un message de type error peut correspondre à un scénario d’échec déclenché volontairement ; une console vide ne prouve pas qu’un formulaire a été correctement enregistré. Lorsque le résultat attendu est une opération d’API, l’attente de la réponse après un clic permet d’identifier l’écriture et de vérifier sa réponse indépendamment du texte d’état de la page. Les messages journalisés documentent cette opération, tandis que les assertions définissent ce qu’elle doit accomplir.
Suivez le marqueur depuis la ligne qui l’émet. Le script de test écrit sur stdout de Node. Pour une ligne émise dans la page, choisissez le gestionnaire selon l’action du script : appel de l’API console ou exception non interceptée.
Enregistrer les listeners avant l’opération déclenchante
Enregistrez les observateurs avant page.goto(), page.setContent() ou le clic qui exécute le code étudié. L’enregistrement est synchrone : page.on() installe la fonction de rappel et retourne sans attendre un futur message. La navigation peut alors commencer avec l’observateur déjà présent. Placer le listener après await page.goto() exclut les messages de démarrage de sa fenêtre d’observation, même si la page reste ensuite ouverte.
Cet exemple CommonJS autonome utilise une page contrôlée avec du HTML intégré et le paquet playwright installé. Il émet des libellés synthétiques sans se connecter à une application externe. Le gestionnaire de console affiche le type et le texte du message ; celui des exceptions emploie un autre préfixe pour distinguer les flux. Les promesses temporaires d’événements identifient les messages exacts requis par cet exemple, sans dépendre d’une pause fixe.
const { chromium } = require('playwright');
(async () => {
const browser = await chromium.launch();
try {
const page = await browser.newPage();
page.on('console', message => {
console.log(`[page console:${message.type()}] ${message.text()}`);
});
page.on('pageerror', error => {
console.error(`[page uncaught] ${error.message}`);
});
const logSeen = page.waitForEvent('console', {
predicate: message => message.text() === 'PAGE_LOG_STARTUP',
timeout: 5000,
});
const errorSeen = page.waitForEvent('pageerror', {
predicate: error => error.message === 'PAGE_UNCAUGHT_STARTUP',
timeout: 5000,
});
console.log('NODE_DRIVER_ONLY');
await Promise.all([
logSeen,
errorSeen,
page.setContent(`<script>
console.log('PAGE_LOG_STARTUP');
console.error('PAGE_CONSOLE_ERROR_STARTUP');
throw new Error('PAGE_UNCAUGHT_STARTUP');
</script>`),
]);
} finally {
await browser.close();
}
})().catch(error => {
console.error(error);
process.exitCode = 1;
});
La valeur de 5000 ms borne l’attente de cet exemple contrôlé ; elle ne recommande pas d’allonger tous les délais d’une application défaillante. Le script lève volontairement une exception dans l’élément script de la page. La lever directement dans un page.evaluate() attendu avec await a une conséquence différente pour le pilote : cette évaluation est rejetée et le test doit traiter ou vérifier ce rejet. Ne remplacez pas le script par une évaluation rejetée en supposant qu’elle démontre le même événement d’exception non interceptée.
La fonction qui journalise les événements s’exécute elle-même dans Node. Son console.log() transfère un message observé du navigateur vers stdout, et son console.error() transfère une exception de page vers stderr. Un rapport qui combine ces flux peut présenter les deux préfixes ensemble. Un système qui capture uniquement stdout peut omettre la ligne d’exception alors que le gestionnaire pageerror s’est exécuté ; vérifiez la configuration des sorties avant de modifier le code du navigateur.
Gardez les fonctions de rappel courtes et nommez-les si le collecteur doit être retiré ensuite. page.off('console', onConsole) retire ce collecteur précis ; supprimer tous les listeners de console pourrait perturber d’autres composants de test. Un collecteur enregistré plusieurs fois sur la même page peut aussi afficher un événement plusieurs fois. Des lignes dupliquées peuvent provenir d’abonnements dupliqués, sans double exécution de l’application.
Comparer les listeners précoces et tardifs sur une page contrôlée
L’expérience sur l’ordre d’abonnement utilise un navigateur neuf pour chaque variante, une page au HTML intégré et des libellés de messages synthétiques. Dans les deux variantes, un observateur de contrôle indépendant s’enregistre avant setContent(). Ce contrôle établit que les deux appels console de démarrage et l’exception initiale non interceptée ont été transmis. L’observateur candidat s’enregistre soit avant l’exécution de la page, soit seulement après que le contrôle a reçu les trois signaux initiaux.
Après l’enregistrement du candidat, la même page émet une deuxième paire de messages console et une autre exception non interceptée. Ces signaux ultérieurs constituent le contrôle positif : ils vérifient que le candidat tardif peut observer une nouvelle activité sur la page dont il a manqué les événements initiaux. Sans cette étape, son silence pourrait aussi indiquer un collecteur défectueux, une mauvaise référence de page ou une fermeture prématurée.
Le 2026-11-18, le cas de test contrôlé s’est terminé avec Playwright 1.58.0, Chrome 157.0.8103.79 standard et Node v26.9.0 sur macOS arm64. Les deux variantes ont validé leurs assertions. Le tableau porte uniquement sur les marqueurs synthétiques exacts, pas sur tous les diagnostics possibles du navigateur. La destination attendue dépend du lieu d’exécution de chaque appel ; la colonne observée distingue les appels en direct au candidat des lectures de l’historique conservé.
| Origine du message | Destination ou comportement attendu | Observation dans le cas de test contrôlé |
|---|---|---|
Pilote Node : console.log('NODE_DRIVER_ONLY') | stdout de Node, hors de la console de page | Affiché sur stdout ; absent des événements console du navigateur dans les deux variantes |
Démarrage de page : console.log('PAGE_LOG_STARTUP') | Événement console de la page, type log | Le candidat précoce l’a reçu ; le candidat tardif l’a manqué en direct |
Démarrage de page : console.error('PAGE_CONSOLE_ERROR_STARTUP') | Événement console de la page, type error, sans exception levée | Le candidat précoce l’a reçu ; le candidat tardif l’a manqué en direct ; aucun pageerror correspondant |
Démarrage de page : throw new Error('PAGE_UNCAUGHT_STARTUP') | Événement pageerror de la page | Le candidat précoce l’a reçu ; le candidat tardif l’a manqué en direct |
La même page émet PAGE_LOG_AFTER_ATTACH, PAGE_CONSOLE_ERROR_AFTER_ATTACH et PAGE_UNCAUGHT_AFTER_ATTACH | Le candidat reçoit les nouveaux signaux émis après son enregistrement | Les deux candidats ont reçu deux messages console et une exception de page non interceptée |
| Historique de la page tardive, lu avant et immédiatement après l’enregistrement du candidat | Les enregistrements conservés peuvent exister séparément de la transmission en direct | Les deux lectures contenaient les deux marqueurs console initiaux et une exception initiale ; aucun événement n’a été rejoué vers les fonctions du candidat |
Le résumé exact de stdout pour cette exécution était :
NODE_DRIVER_ONLY
early: liveConsole=4 livePageErrors=2 retainedConsole=4 retainedPageErrors=2
late: liveConsole=2 livePageErrors=1 retainedConsole=4 retainedPageErrors=2
Les totaux précoces comprennent le démarrage et le contrôle positif. Les totaux en direct du candidat tardif ne contiennent que les marqueurs postérieurs à son enregistrement. À la lecture finale, les deux pages conservaient les quatre marqueurs console et les deux exceptions non interceptées. Le cas de test ne transférait pas les messages de page vers stdout : sa ligne NODE_DRIVER_ONLY démontre donc une véritable sortie du pilote, et non une ligne du navigateur affichée par une fonction de transfert.
Ces résultats distinguent deux explications d’une ligne initiale absente : l’événement s’est produit avant que le candidat puisse l’observer, mais une lecture ultérieure de l’historique a encore retrouvé son enregistrement. Placer un listener juste après la navigation ne garantit pas le même résultat ; l’application peut émettre son message plus tard. La variante volontairement tardive établit la transmission préalable grâce au contrôle indépendant, sans supposer que la fin de la navigation prouve que tous les appels de journalisation sont terminés.
La comparaison concerne l’ordre des observateurs et les catégories d’événements. Elle ne mesure ni le débit de l’application, ni la latence réseau, ni le comportement de BotBrowser, et ne couvre pas les workers, fenêtres contextuelles ou frames. Les libellés initiaux et postérieurs à l’enregistrement évitent aussi un comptage ambigu dans lequel un avertissement sans rapport ressemblerait au message recherché.
Lire l’historique récent sans supposer un journal complet
Playwright v1.56 a introduit page.consoleMessages() et page.pageErrors(). La documentation actuelle indique que chaque méthode renvoie au maximum les 200 derniers enregistrements de cette page. Elles permettent une lecture diagnostique tardive, mais cette collection limitée diffère d’un appel de fonction en direct et d’un fichier journal durable.
Lisez les deux collections tant que la Page concernée est disponible et identifiez la sortie comme un historique. Cet extrait suppose que l’application a déjà atteint un état où les messages recherchés devraient s’être produits. Il utilise volontairement les formes sans argument disponibles en v1.56 plutôt que les options plus récentes présentées dans la documentation actuelle.
const recentConsole = await page.consoleMessages();
const recentErrors = await page.pageErrors();
for (const message of recentConsole) {
console.log(`[history console:${message.type()}] ${message.text()}`);
}
for (const error of recentErrors) {
console.error(`[history uncaught] ${error.message}`);
}
Ces deux lectures sont des instantanés pris par des appels séparés, pas un enregistrement atomique de tout le navigateur. D’autres activités peuvent survenir entre elles. Lire une collection n’installe pas non plus une condition d’attente d’un événement futur précis. Si le test doit attendre un nouveau message connu, enregistrez page.waitForEvent('console', { predicate }) avant de le déclencher et bornez l’attente comme dans l’exemple précédent.
Une entrée absente de l’historique admet plusieurs explications : l’appel ne s’est pas exécuté, il appartient à une autre page ou il se situe hors de la collection conservée. Une page très bavarde peut repousser un ancien message au-delà de la limite documentée. Le cas de démarrage contrôlé utilise seulement quelques libellés exacts ; il ne teste pas la rétention sous une journalisation continue et ne prouve pas que chaque message ancien est récupérable.
Vérifiez la version du paquet utilisé par le processus qui exécute réellement le test. Lancez npm ls playwright playwright-core @playwright/test dans ce projet, puis comparez les paquets résolus avec les imports et le fichier de verrouillage. Une CLI globale peut avoir une autre version que la bibliothèque importée localement. Un ancien paquet peut gérer les événements en direct sans posséder ces nouvelles méthodes d’historique ; modifier les options du navigateur n’ajoute pas une méthode absente de la bibliothèque Node.
Pour une ancienne installation de Playwright dont la version doit rester figée, un collecteur en direct enregistré tôt constitue la solution de repli pratique. Conservez uniquement les champs nécessaires au diagnostic et choisissez une limite de rétention explicite adaptée au test. Ne qualifiez pas ce tableau local d’historique complet du navigateur : il couvre la fenêtre d’abonnement du collecteur et les événements acceptés par ses filtres. Les API d’historique facilitent l’inspection, tandis qu’une collecte précoce permet au test de gérer le cycle de vie de ses preuves.
Distinguer le type, les arguments et l’emplacement du message
L’API ConsoleMessage fournit text(), type(), args() et location(). Commencez par le type et le texte, qui sont des valeurs synchrones simples. Au premier diagnostic, capturez tous les types au lieu de filtrer sur error. Un console.log() ordinaire de la page produit un message log et disparaîtrait d’un collecteur limité aux erreurs, même avec un abonnement parfaitement placé.
Utilisez les noms de types renvoyés par Playwright au lieu de les déduire du nom de la méthode du navigateur. Le type documenté pour console.warn() est par exemple warning. Un filtre sur le littéral warn l’exclut silencieusement. Préfixez les lignes transférées par leur origine et leur type afin de distinguer les diagnostics du test des messages reçus de la page.
text() fournit une représentation textuelle, sans garantir que chaque objet est préservé en JSON. Si une application contrôlée journalise console.log('save', { revision: 7 }), utilisez args() lorsque la valeur de chaque argument compte. Ces arguments sont des objets JSHandle, et lire les valeurs sérialisables nécessite d’attendre le jsonValue() de chaque handle. Les éléments DOM, structures circulaires et objets au comportement particulier demandent plus de précautions qu’un simple enregistrement de révision.
Séparez l’extraction asynchrone des arguments du compteur synchrone d’événements. Si un gestionnaire asynchrone commence à lire un objet puis que la page navigue ou se ferme, l’extraction peut échouer alors que l’événement a déjà été reçu. Il s’agit d’un échec de lecture de l’artefact, pas d’une preuve d’absence d’événement console. Enregistrez immédiatement le type et le texte de base, puis traitez explicitement les erreurs de sérialisation dans un collecteur plus détaillé.
location() aide à distinguer un bundle applicatif d’un script de test injecté. Son URL de ressource et ses coordonnées source à partir de zéro indiquent où Playwright situe l’appel console, pas nécessairement la ligne du code original avant regroupement. Évitez d’ajouter un à une position déjà convertie pour la lecture humaine ailleurs dans la chaîne de rapport. Les emplacements vides ou synthétiques doivent rester identifiés comme tels, sans recevoir un nom de fichier applicatif inventé.
Limitez les données conservées à la question diagnostique. Les journaux du navigateur et les arguments sérialisés peuvent contenir des jetons de session, des informations personnelles ou des réponses d’API complètes ; les URL source peuvent inclure des paramètres de requête. Les libellés PAGE_LOG_STARTUP du cas de test sont partageables parce qu’ils sont synthétiques. Pour un rapport réel, sélectionnez des identifiants d’opération inoffensifs et masquez les valeurs sensibles avant de transférer stdout ou de joindre des artefacts à un ticket partagé.
Diagnostiquer un listener silencieux sans masquer les défaillances
Commencez par émettre un message inoffensif depuis l’objet de page précis qui possède le collecteur. Créez une promesse waitForEvent('console') avec un prédicat synthétique exact avant page.evaluate(() => console.log('OWNED_DIAGNOSTIC_MARKER')), puis attendez les deux opérations. Si l’événement arrive, le chemin actuel entre page et pilote fonctionne pour ce message. Cela ne prouve pas que l’application a émis un ancien message de démarrage ni qu’une fenêtre contextuelle utilise le même objet de page.
Vérifiez ensuite l’identité de la page. Une fenêtre contextuelle ou un onglet créé séparément constitue une autre Page ; un listener sur la page initiale ne décrit pas nécessairement l’exécution du nouvel onglet. Enregistrez l’observateur nécessaire dans la gestion de création des pages du test et identifiez les enregistrements par page. Un listener de page peut recevoir des appels console de ses frames : une URL de frame enfant dans location() ne prouve donc pas à elle seule un mauvais abonnement.
Retirez ensuite temporairement les filtres de diagnostic et comparez console avec pageerror. Un console.error() attendu dans le premier et une exception levée dans le second exigent des assertions différentes. Ne faites pas échouer toute la suite pour chaque chaîne de niveau erreur, sauf si cette règle appartient explicitement au contrat de l’application. Ne supprimez pas non plus toutes les exceptions pour faire réussir une vérification de sortie ; des exceptions initiales inattendues peuvent expliquer pourquoi l’action recherchée ne s’est jamais exécutée.
Lorsque l’échec dépend d’une navigation, d’un clic ou d’un changement d’onglet, rapprochez les messages observés des preuves issues de la même exécution défaillante. L’analyse des traces Playwright permet d’inspecter ensemble les actions et l’état de la page. Une nouvelle exécution réussie avec davantage de messages journalisés peut aider à reproduire le problème, mais ne reconstitue pas les messages qu’une ancienne exécution n’a pas conservés.
Enfin, conservez les assertions applicatives. Recevoir un message save complete signifie que cet appel de journalisation s’est exécuté ; cela ne prouve pas que le serveur a validé les données ni que le DOM attendu est apparu. Gardez les vérifications d’API et d’interface qui définissent la réussite, et utilisez les preuves de console pour expliquer leurs échecs. Cela évite de remplacer un problème de messages absents par un test qui réussit sur un message optimiste.
La documentation d’intégration Playwright de BotBrowser décrit le lancement de son exécutable par Playwright avec une configuration fondée sur un profil. Cette configuration du navigateur est distincte du choix du point d’enregistrement du collecteur, de sa destination de transfert et de ses assertions. La comparaison sur une page contrôlée au HTML intégré isole ces choix de gestion d’événements ; elle n’établit rien sur un profil, un service distant ou une application en production.
Questions fréquentes
Le mode avec interface affiche-t-il console.log du navigateur sur stdout de Node ?
Ouvrir un navigateur visible n’ajoute pas une fonction de transfert au script Node. DevTools et le processus de test restent des destinations distinctes. Gardez le même observateur page.on('console') dans les tests avec et sans interface, puis comparez le message exact et l’identité de la page si l’application se comporte différemment selon le mode.
console.error fait-il automatiquement échouer un test Playwright ?
Un événement console de page fournit une preuve au test, et console.error() ne lève pas lui-même d’exception. Définissez une assertion ou une règle d’échec fondée sur le collecteur si certains messages d’erreur doivent faire échouer le test. Une exception directe de Node ou une opération attendue puis rejetée suit les règles d’échec propres au processus de test et doit être diagnostiquée séparément.
Un bloc catch peut-il empêcher l’apparition de pageerror ?
Une exception traitée par le code applicatif diffère d’une exception non interceptée. Si l’application l’intercepte puis journalise un message, l’observateur console peut le recevoir alors que celui des exceptions non interceptées n’a rien à signaler. Inspectez le résultat traité ou l’état d’erreur explicite exigé par le contrat de l’application.
L’historique récent peut-il remplacer les fichiers journaux en CI ?
Les méthodes d’historique renvoient des enregistrements de page limités lors de leur consultation ; elles n’organisent pas leur rétention en CI et n’offrent pas de stockage illimité. Lisez les enregistrements pertinents avant la fermeture et joignez la sortie choisie par le mécanisme d’artefacts du processus de test. Indiquez la version résolue de Playwright pour rendre reproductible la disponibilité de l’API d’historique.
Sources
- Playwright : événement console de Page et messages récents
- Playwright : exceptions non interceptées de Page
- Playwright : page.consoleMessages
- Playwright : page.pageErrors
- Playwright : ConsoleMessage
- Node.js : console
- BotBrowser : intégration Playwright
Conclusion pratique
Pour des messages de console Playwright absents, identifiez l’environnement émetteur, enregistrez le bon observateur de page avant l’exécution et transférez ou conservez explicitement les messages reçus. Utilisez les lectures d’historique de v1.56+ comme des instantanés diagnostiques limités. Commencez par un message synthétique sur la page contrôlée, puis vérifiez le déclencheur d’origine de l’application sans remplacer ses assertions de réponse et d’interface.
Cet article fait partie du guide : Débuter avec l'automatisation du navigateur : carte initiale
Articles Connexes
Playwright : attendre la réponse après un clic
DémarrageTrace Viewer Playwright pour déboguer des tests autorisés
DémarrageÉvénements WebDriver BiDi pour une automatisation stable
DémarrageChrome DevTools MCP ou Playwright MCP pour déboguer
DémarrageScraping avec Playwright : navigateur et profil
EmpreinteRaison d’annulation, composition et écouteurs tardifs
Exécutez la même vérification dans BotBrowser
Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.