Les logs réseau de Chrome, capturés avec chaque rapport de bug
Mis à jour le
Midge capture automatiquement les logs réseau de Chrome avec chaque rapport de bug. Les requêtes fetch et XHR arrivent avec les 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 au fil de leur envoi et de leur réception ; les scripts, styles, images et polices sont listés avec leur statut, leur taille et leur durée. Un développeur peut ouvrir n’importe quelle requête, la copier en cURL ou télécharger tout le log sous forme de fichier HAR masqué.
Pas besoin d’ouvrir les DevTools, et la personne qui signale le bug n’a pas besoin de savoir ce qu’est un fichier HAR. Chaque enregistrement contient les logs console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil.
Pourquoi le panneau Réseau des DevTools ne suffit pas
Le panneau Network de Chrome est excellent quand c’est vous qui déboguez. Pour les rapports de bug, il pose trois problèmes :
- Il doit être ouvert avant la requête. Les requêtes faites avant l’ouverture des DevTools n’y figurent pas, et la plupart des gens l’ouvrent après le bug.
- Il se vide à chaque navigation, sauf si quelqu’un a pensé à cocher « Preserve log ».
- Un export HAR contient des secrets. Cookies, en-têtes
Authorizationet tokens dans les query strings finissent tous dans le fichier. Notre guide sur comment retirer les données sensibles d’un fichier HAR explique pourquoi c’est important.
Midge capture l’activité réseau en arrière-plan sur chaque page, garde les requêtes récentes en mémoire et les joint quand vous créez un rapport. Les secrets sont retirés avant le téléversement.
À quoi ressemble une requête dans un rapport
Chaque requête est placée sur la même timeline que la vidéo et la console. Ouvrez-en une et vous voyez l’échange complet :
POST /api/v2/invoices HTTP/1.1
Content-Type: application/json
Authorization: [REDACTED]
{"customerId": "cus_8812", "lines": [{"sku": "PRO-M", "qty": 3}]}
HTTP/1.1 409 Conflict
Content-Type: application/json
{"error": "invoice_already_open", "invoiceId": "inv_3021"}
En plus des corps, vous obtenez le code de statut, la durée et le moment où la requête a démarré. Comme les requêtes sont triées par heure à côté de la vidéo, le 409 ci-dessus se trouve juste après le clic qui l’a provoqué, au lieu d’être noyé parmi des dizaines de chargements d’images.
Messages WebSocket
Les applications temps réel échouent souvent sur un socket, pas en HTTP. Midge enregistre les messages WebSocket dans les deux sens avec leur horodatage : vous pouvez ainsi voir que le serveur a envoyé {"type":"price_update"} deux fois et que le client n’a affiché que le premier.
Autres ressources
Les scripts, feuilles de style, images, polices et documents sont listés avec leur code de statut, leur taille et leur durée, sans leur corps. C’est généralement ce qu’il vous faut : un 404 sur app.4f2c1.js après un déploiement, ou une image d’en-tête de 3 Mo qui retarde le premier affichage.
GraphQL, bien géré
GraphQL rend les logs réseau difficiles à lire. Toutes les requêtes vont vers le même endpoint /graphql, et les erreurs reviennent souvent avec un HTTP 200 :
{
"data": { "updateProfile": null },
"errors": [{ "message": "Not authorized to update this profile", "path": ["updateProfile"] }]
}
Midge affiche le nom de l’opération, comme UpdateProfile, à côté de chaque requête GraphQL et signale les réponses 200 qui contiennent un tableau errors. Un échec qu’un filtre sur le code de statut cacherait est marqué comme un échec.
Copier en cURL
Toute requête capturée peut être copiée sous forme de commande cURL : un développeur back-end peut la rejouer depuis un terminal et obtenir la même réponse. Comme le masquage passe en premier, l’en-tête Authorization et les cookies arrivent sous la forme [REDACTED]. Remplacez-les par un token de votre propre compte de test et lancez la commande. C’est voulu : un rapport de bug ne doit jamais distribuer une session valide.
Exporter un HAR masqué
Certaines équipes et certains fournisseurs veulent un fichier HAR. Midge vous permet de télécharger le log réseau d’un rapport au format HAR, et le fichier contient les données masquées. Vous pouvez l’ouvrir dans le lecteur HAR gratuit, ou le joindre à un ticket de support chez un fournisseur d’API sans divulguer vos clés. Si vous avez un HAR exporté directement depuis les DevTools, nettoyez-le avec le nettoyeur HAR, qui applique les mêmes règles que l’extension.
Ce qui est masqué
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. Dans les données réseau, cela concerne :
- Les en-têtes
Authorization,Cookie,Set-Cookie, de clé d’API et CSRF, ainsi que tout en-tête dont le nom contient des mots comme token, secret, session ou auth. - Les paramètres d’URL sensibles comme
access_token,code,api_keyetsignature. - Les champs de corps comme
password,otp,cvv,ibanoucard_number, y compris imbriqués. - Les JWT, les numéros de carte valides selon l’algorithme de Luhn et les formats de clés d’API connus, où qu’ils se trouvent dans le contenu.
Les e-mails et les numéros de téléphone internationaux sont masqués à moitié. La liste complète se trouve sur la page sur le masquage.
Limites
Les corps de requête et de réponse sont capturés pour fetch, XHR et WebSocket ; les autres types de ressources n’affichent que des métadonnées. Le trafic des applications hors de Chrome ne fait pas partie du rapport, et Midge ne s’exécute pas sur les sites que vous avez ajoutés à sa liste d’exclusion. Si vous avez besoin d’une capture complète au niveau du navigateur pour une enquête ponctuelle, notre guide sur la capture du trafic réseau dans Chrome détaille la méthode via les DevTools.
Midge est gratuit : enregistrements illimités, vidéos jusqu’à 15 minutes et aucun filigrane.
Questions fréquentes
- Quelles requêtes Midge capture-t-il ?
- Les requêtes fetch et XHR avec les en-têtes, les corps de requête et de réponse, les codes de statut et les timings, ainsi que les messages WebSocket. Les autres ressources, comme les scripts, feuilles de style, images, polices et documents, sont listées avec leur statut, leur taille et leur durée.
- Puis-je exporter le log réseau en fichier HAR ?
- Oui. Le log réseau d’un rapport peut être téléchargé au format HAR, et le fichier contient les données masquées, pas les valeurs brutes.
- Comment Midge gère-t-il GraphQL ?
- Il affiche le nom de l’opération pour chaque requête GraphQL et signale les réponses qui renvoient un HTTP 200 mais contiennent un tableau errors, ce qu’un filtre sur le code de statut laisserait passer.
- La copie en cURL inclut-elle mon token d’authentification ?
- Non. Les en-têtes Authorization et les cookies sont masqués avant le téléversement : la commande copiée contient donc [REDACTED] à leur place. Ajoutez votre propre token quand vous l’exécutez.