Aller au contenu

Des rapports de bug pour développeurs : les indices que vous auriez collectés vous-même

Mis à jour le

Un rapport de bug pour développeurs fonctionne au mieux quand il contient ce que vous auriez collecté vous-même : l’erreur console avec sa stack trace, la requête en échec avec son corps, les étapes qui y ont mené et le navigateur concerné. Midge capture tout cela automatiquement depuis un onglet Chrome, l’aligne avec la vidéo sur une seule timeline et masque les secrets avant le téléversement : le rapport peut donc être collé sans risque dans un ticket, une pull request ou un chat d’IA.

Chaque enregistrement contient les logs console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil. Résultat : moins de messages « tu peux m’envoyer la console ? » et plus de bugs corrigés dès la première lecture.

Ce que contient un rapport

Une seule timeline

La vidéo se trouve à côté d’un panneau de messages console, de requêtes réseau et d’actions utilisateur, le tout classé dans l’ordre chronologique. Regardez le clic sur Save : le PATCH /api/projects/88 qui l’a suivi est juste là, avec le Uncaught TypeError quelques millisecondes après l’arrivée de la réponse. Pas besoin de reconstituer la séquence à partir de trois pièces jointes.

La console avec les stack traces

Tous les niveaux, de debug à error, plus les exceptions non interceptées et les rejets de promesses non gérés, avec leurs piles d’appels. Midge commence à écouter dès le chargement de la page, donc les erreurs de démarrage sont incluses, et il garde une mémoire tampon glissante : les erreurs survenues avant que le testeur n’appuie sur Enregistrer sont toujours là. Les détails sont sur la page des logs console.

Le détail du réseau

Les requêtes fetch et XHR arrivent avec leurs en-têtes, les corps de requête et de réponse, les codes de statut et les timings. Les messages WebSocket sont enregistrés dans les deux sens. Les autres ressources affichent statut, taille et timing. Pour GraphQL, chaque requête affiche le nom de son opération, et les réponses 200 qui contiennent un tableau errors sont signalées, car un filtre par statut les manquerait. Plus d’informations sur la page des logs réseau.

Les infos sur l’appareil

Navigateur et version, système d’exploitation, taille de la fenêtre, langue, fuseau horaire et URL. De quoi reproduire le même environnement, ou remarquer que le bug ne se produit qu’avec une locale allemande.

Copier en cURL

Toute requête peut être copiée sous forme de commande cURL et lancée depuis votre terminal :

curl 'https://staging.acme.dev/api/projects/88' \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -H 'Authorization: [REDACTED]' \
  --data-raw '{"name":"Q4 roadmap","archived":null}'

L’en-tête Authorization masqué est voulu. Mettez-y le token de votre propre utilisateur de test, et vous reproduisez exactement la requête sans que personne n’ait à partager une session active. Pour examiner un token de votre propre environnement, le décodeur JWT gratuit affiche ses claims et son expiration sans l’envoyer nulle part.

Télécharger un HAR masqué

Quand vous avez besoin de tout le log réseau, pour une question de performance ou pour l’équipe de support d’un fournisseur d’API, téléchargez-le sous forme de fichier HAR. Le fichier contient les données masquées. Ouvrez-le dans le lecteur HAR gratuit, ou dans n’importe quel outil qui lit le HAR. Si vous partez d’un HAR que quelqu’un a exporté directement depuis les DevTools, lisez comment retirer les données sensibles d’un fichier HAR avant de le transmettre.

Un masquage qui permet de coller les rapports sans risque

Les rapports de bug finissent collés partout : tickets, fils Slack, descriptions de pull request, chats avec des assistants de code. 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. Cela comprend :

  • les en-têtes Authorization, Cookie et Set-Cookie, et tout en-tête dont le nom contient token, secret, session ou auth,
  • les paramètres d’URL sensibles comme access_token, code et signature,
  • les champs de corps comme password, otp, cvv et client_secret,
  • les JWT, les numéros de carte valides selon l’algorithme de Luhn, les clés privées et les clés d’API de Stripe, AWS, GitHub, Slack, Google, OpenAI et Anthropic.

Les ID de requête et autres valeurs d’apparence aléatoire sont conservés exprès, car vous en avez besoin pour retrouver les logs serveur correspondants. Le masquage repose sur des règles ; si votre app a ses propres champs secrets, ajoutez-les à la liste de votre espace de travail. Les règles complètes sont sur la page sur le masquage.

Travailler avec des agents de code

Midge dispose d’un serveur MCP à l’adresse https://midge.dev/mcp : Claude Code, Cursor et d’autres agents peuvent lire directement la console, le réseau et les actions d’un rapport. Collez le lien du rapport dans le chat, et l’agent récupère ce dont il a besoin avec des outils en lecture seule comme get_console, get_network et get_user_actions. Il se connecte via votre navigateur, ou utilise un token créé dans Settings › Account › AI assistants. Vous pouvez toujours copier la requête en échec en cURL ou joindre le HAR masqué. Dans tous les cas, les données sont déjà nettoyées.

Obtenir de meilleurs rapports de votre équipe

Le meilleur outil dépend toujours de ce que les gens capturent. Partagez notre guide comment rédiger un rapport de bug avec les testeurs et le support, et orientez-les vers l’enregistreur d’écran. Midge est gratuit : enregistrements illimités, vidéos jusqu’à 15 minutes et aucun filigrane, donc personne n’a à économiser ses enregistrements.

Questions fréquentes

Que voit un développeur en ouvrant un rapport Midge ?
La vidéo ou la capture d’écran, avec à côté les messages console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil, classés dans l’ordre chronologique. Les requêtes affichent en-têtes, corps, codes de statut et timings.
Puis-je rejouer une requête en échec ?
Oui. Toute requête capturée peut être copiée sous forme de commande cURL. Les en-têtes d’authentification et les cookies sont masqués : vous ajoutez donc le token de votre propre compte de test avant de la lancer.
Puis-je coller sans risque un rapport Midge dans une issue publique ou un chat d’IA ?
Midge retire mots de passe, numéros de carte, tokens, cookies et formats connus de clés d’API avant le téléversement. Le masquage repose sur des règles, donc relisez tout ce qui sort de l’ordinaire, mais les secrets courants ont déjà disparu.
Puis-je utiliser Midge pour mon propre débogage ?
Oui. Enregistrer un bug que vous avez trouvé vous-même est un moyen rapide de le confier à un coéquipier ou d’y revenir plus tard avec les logs intacts.