Un enregistreur d’écran avec logs console, y compris les erreurs d’avant l’enregistrement
Mis à jour le
Midge est un enregistreur d’écran avec logs console. Pendant que vous enregistrez votre écran ou prenez une capture d’écran dans Chrome, il capture chaque message console produit par la page, de console.log aux exceptions non interceptées et aux rejets de promesses non gérés, avec les stack traces, et les aligne sur la vidéo. Comme Midge garde un tampon glissant de la sortie console récente, une erreur déclenchée avant que vous n’appuyiez sur Enregistrer figure quand même dans le rapport.
C’est justement ce second point qui manque à la plupart des rapports de bug. Le temps de remarquer que quelque chose a cassé, l’erreur a déjà défilé dans une fenêtre DevTools que personne n’avait ouverte. Midge supprime l’étape « Vous pouvez le reproduire avec la console ouverte ? ».
Ce qui est capturé
Tous les niveaux de la console
Midge enregistre les appels log, info, warn, error et debug avec leur horodatage et les valeurs qui leur sont passées. Les avertissements comptent plus qu’on ne le pense : un avertissement de clé React ou un avis de dépréciation loggé juste avant un plantage est souvent le vrai indice.
Les erreurs non interceptées
Les exceptions que personne n’intercepte ne passent jamais par console.error. Elles remontent jusqu’à la fenêtre et le navigateur les affiche en rouge. Midge les écoute aussi : un plantage dans un gestionnaire d’événements apparaît même si votre application ne loggue rien du tout.
Les rejets de promesses non gérés
Une promesse rejetée sans .catch() est l’un des échecs silencieux les plus courants dans les front-ends modernes. Un bouton « ne fait rien » parce qu’un fetch a été rejeté et que personne ne l’a géré. Midge enregistre ces rejets et la raison qu’ils portent.
Les stack traces
Pour les erreurs, Midge sauvegarde la stack trace fournie par le navigateur. Une entrée typique ressemble à ceci :
Uncaught (in promise) TypeError: Failed to fetch
at submitOrder (orders.js:88:15)
at HTMLButtonElement.onClick (checkout.js:41:9)
Si votre bundle de production est minifié, la stack affiche les noms de fichiers et les positions minifiés, exactement tels que le navigateur les a rapportés : gardez donc vos source maps sous la main quand vous lisez un rapport venu de la production.
Capturé avant même d’appuyer sur Enregistrer
Midge commence à écouter dès que chaque page commence à se charger, avant que les scripts de votre application ne s’exécutent : même les erreurs levées au démarrage sont donc capturées. Il garde en mémoire les dernières minutes de sortie console de chaque onglet ouvert.
Quand vous lancez un enregistrement d’écran ou prenez une capture d’écran, cet historique récent y est joint. Concrètement, vous pouvez travailler normalement, remarquer que quelque chose cloche, et seulement ensuite décider de le signaler. L’erreur rouge d’il y a 20 secondes est toujours sur la timeline.
Quelques points sur ce tampon :
- Il vit uniquement en mémoire et est effacé à la fermeture de l’onglet.
- Rien ne quitte votre ordinateur tant que vous ne créez pas de rapport.
- Il fonctionne sur les pages http et https classiques. Vous pouvez ajouter des sites sur lesquels Midge ne doit jamais s’exécuter, comme celui de votre banque ou un gestionnaire de mots de passe.
Console et vidéo sur une seule timeline
Chaque enregistrement contient les logs console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil. Dans le rapport, la console se trouve à côté de la vidéo, triée par heure. Regardez le moment où la fenêtre modale refuse de s’ouvrir : le TypeError correspondant est juste là, quelques lignes sous le clic qui l’a déclenché.
Les erreurs vont naturellement de pair avec l’activité réseau. Un 500 sur /api/orders suivi de Cannot read properties of undefined raconte toute l’histoire : le serveur a échoué et le client n’a pas géré l’échec. Pour en savoir plus, voir la page logs réseau.
Les secrets dans la sortie console
Les développeurs loggent des choses qu’ils ne devraient pas, surtout pendant le débogage : un token, un objet utilisateur complet, une URL de requête avec une clé d’API dans la query string. Midge applique au texte de la console les mêmes règles de masquage qu’aux données réseau. Mots de passe, numéros de carte, tokens et cookies sont masqués dans votre navigateur avant que quoi que ce soit ne quitte votre appareil.
Par exemple, cette ligne :
auth ok: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123 for [email protected]
apparaît ainsi dans le rapport :
auth ok: [REDACTED] for j***@acme.com
La liste complète des règles, et ce que le masquage ne détecte pas, se trouve sur la page sur le masquage.
Midge ou l’export manuel de la console
Vous pouvez sauvegarder vous-même la sortie console depuis les Chrome DevTools ; notre guide sur comment exporter les logs console dans Chrome explique la marche à suivre. Ça marche, mais avec des lacunes. Les DevTools doivent être ouverts avant que l’erreur ne survienne, l’export est du texte brut sans la vidéo, et rien n’en retire les secrets. Si vous exportez des logs ou un fichier HAR à la main, passez le HAR dans le nettoyeur HAR gratuit avant de le joindre à un ticket.
Avec Midge, la console est capturée que les DevTools aient été ouverts ou non, elle est synchronisée avec ce que vous avez vu, et elle est masquée avant le téléversement.
Qui lit ces logs
Les testeurs QA arrêtent de coller des bouts de stack traces dans les tickets. Les agents du support peuvent joindre la vraie sortie d’erreur à une escalade sans savoir ce qu’est une console. Les développeurs obtiennent l’erreur exacte, la stack et les appels réseau qui l’entourent au même endroit. Si c’est votre rôle, voir Midge pour les développeurs.
Midge est gratuit : enregistrements illimités, vidéos jusqu’à 15 minutes et aucun filigrane.
Questions fréquentes
- Quels messages console Midge capture-t-il ?
- Les cinq niveaux : log, info, warn, error et debug. Il enregistre aussi les exceptions non interceptées et les rejets de promesses non gérés, qui ne passent jamais par console.error, avec leurs stack traces.
- Midge peut-il capturer une erreur survenue avant que je lance l’enregistrement ?
- Oui. Midge garde en mémoire les dernières minutes de sortie console de chaque onglet : un enregistrement ou une capture d’écran réalisés juste après une erreur la contiennent donc toujours. Ce tampon est effacé quand vous fermez l’onglet et ne quitte jamais votre appareil, sauf si vous créez un rapport.
- Les secrets présents dans les messages console sont-ils masqués ?
- Oui. Les JWT, numéros de carte, formats de clés d’API connus, clés privées et paramètres d’URL sensibles sont retirés du texte de la console, et les e-mails et numéros de téléphone internationaux sont masqués à moitié.
- Dois-je ouvrir les DevTools ?
- Non. Midge capture la console sans que les DevTools soient ouverts, et la personne qui ouvre votre rapport voit les messages à côté de la vidéo.