Aller au contenu

Comment rédiger un rapport de bug exploitable

Rédiger un rapport de bug qui sera corrigé : titre précis, étapes de reproduction exactes, résultat attendu et obtenu, environnement et preuves.

Pour rédiger un rapport de bug exploitable par les développeurs, reproduisez d’abord le problème, puis écrivez un titre précis d’une ligne, l’environnement (URL, navigateur et version, système d’exploitation, compte), des étapes de reproduction numérotées partant d’un point de départ connu, le résultat attendu, le résultat obtenu avec les messages d’erreur exacts, et joignez des preuves comme une capture d’écran ou un enregistrement, les erreurs console et la requête réseau en échec. Un bug par rapport.

Le test d’un bon rapport est simple : un développeur qui n’a jamais vu le problème pourrait-il le déclencher sur sa propre machine, sans rien vous demander ? Si oui, le bug sera probablement corrigé vite. S’il doit revenir vers vous avec des questions, chaque aller-retour coûte une journée. Si vous voulez les champs sous forme de checklist, copiez notre modèle de rapport de bug.

1. Reproduisez-le avant d’écrire

Essayez de déclencher le bug une seconde fois. Ce faisant, soyez attentif aux détails qui pourraient compter :

  • Quel compte ou quel rôle vous utilisiez.
  • Quelles données étaient en jeu : un produit précis, un nom très long, une liste vide, un gros fichier.
  • Quelles étapes sont vraiment nécessaires. Retirez-les une à une pour trouver le chemin le plus court.
  • S’il se produit dans un autre navigateur ou en navigation privée.

S’il se produit à chaque fois, parfait. S’il ne se produit que parfois, comptez : « 4 essais sur 10 ». Si vous n’arrivez pas du tout à le reproduire, signalez-le quand même, en le disant clairement.

2. Vérifiez s’il a déjà été signalé

Cherchez dans l’outil de suivi le message d’erreur, le nom de la page et quelques mots-clés. Si vous trouvez une correspondance, ajoutez-y vos détails au lieu d’ouvrir un nouveau ticket : votre environnement, une nouvelle façon de le déclencher, ou le fait qu’il se produit toujours sur le dernier build. Les doublons éparpillent l’information entre plusieurs tickets et font perdre du temps au tri.

3. Écrivez un titre précis

Le titre est souvent la seule chose qu’on lit pendant le tri. Il doit décrire le problème, pas la fonctionnalité.

Titre faibleMeilleur titre
Connexion casséeLa connexion avec Google renvoie en boucle vers la page de connexion dans Safari
Bug dans les rapportsL’export CSV du rapport Ventes perd des lignes au-delà de 1 000
Page lenteLa page Facturation met plus de 10 secondes à charger pour les comptes avec beaucoup de factures
Erreur à l’enregistrementEnregistrer un profil avec un emoji dans le nom renvoie « Invalid input »

Une formule utile : ce qui est cassé, plus quand cela se produit, plus où.

4. Décrivez l’environnement

Beaucoup de bugs n’apparaissent que dans une configuration précise. Indiquez :

  • L’URL de la page où c’est arrivé.
  • Le navigateur et sa version, par exemple Chrome, Firefox, Safari ou Edge avec le numéro de version indiqué dans la page « À propos ».
  • Le système d’exploitation et l’appareil.
  • La taille d’écran s’il s’agit d’un problème de mise en page.
  • La version ou le build de l’application, si elle en affiche un.
  • Le compte, le rôle ou l’utilisateur de test, et ce qu’il a de particulier (un compte d’essai, une grande organisation, une langue autre que l’anglais).
  • L’heure à laquelle c’est arrivé, avec le fuseau horaire, pour que l’équipe le retrouve dans les logs serveur.

5. Écrivez les étapes de reproduction

Les étapes sont le cœur du rapport. De bonnes étapes :

  • Partent d’un état connu : « Connecté en tant qu’admin, sur le tableau de bord ».
  • Contiennent une seule action par étape numérotée.
  • Nomment les données exactes : le produit, le fichier, le texte saisi. N’y mettez jamais de vrais mots de passe ou numéros de carte ; utilisez des données de test.
  • Reprennent les libellés affichés dans l’application, en gras ou entre guillemets, pour que le développeur trouve le même bouton.
  • S’arrêtent au moment où le bug apparaît.
1. Se connecter avec [email protected] (rôle Admin).
2. Aller dans Settings, puis Team.
3. Cliquer sur « Invite member ».
4. Saisir « [email protected] » et choisir le rôle « Viewer ».
5. Cliquer sur « Send invite ».

6. Écrivez le résultat attendu et le résultat obtenu

Mettez-les côte à côte :

Attendu : L’invitation apparaît dans la liste Pending et un toast de confirmation s’affiche.
Obtenu : La boîte de dialogue se ferme, aucun toast ne s’affiche et la liste Pending reste vide.
         Après rechargement, l’invitation n’apparaît toujours pas.

Décrivez ce que vous avez observé, pas ce qui l’a causé selon vous. « La requête d’invitation a échoué » est une conclusion ; « la boîte de dialogue s’est fermée et rien n’est apparu dans la liste » est une observation. Si vous avez vu un message d’erreur, copiez-le en texte, mot pour mot. Les développeurs cherchent cette chaîne dans leur code.

7. Ajoutez des preuves

Les preuves transforment une description en démonstration, et pointent souvent directement vers la cause.

  • Une capture d’écran avec la zone du problème mise en évidence. Recadrez pour retirer les données personnelles sans rapport.
  • Un enregistrement d’écran pour tout ce qui implique un mouvement, un timing ou plusieurs étapes. Faites-le court et commencez juste avant le problème.
  • Les erreurs console. Dans les applications web, une erreur rouge dans la console du navigateur est souvent l’indice le plus utile. Voir comment exporter les logs console dans Chrome.
  • La requête réseau en échec. L’URL, le code de statut et le corps de réponse de l’appel d’API qui a échoué. Voir comment capturer le trafic réseau dans Chrome.
  • Un fichier HAR si l’équipe demande toute la session réseau. Suivez comment obtenir un fichier HAR et nettoyez-le d’abord avec le nettoyeur HAR, car les fichiers HAR contiennent des cookies et des tokens.

8. Évaluez l’impact honnêtement

Dites à quel point c’est grave et combien de personnes sont touchées. Utilisez l’échelle de gravité de votre équipe s’il y en a une. Soyez honnête : si tout est marqué critique, plus rien ne l’est. Mentionnez un contournement si vous en avez trouvé un ; cela change l’urgence de la correction et aide le support en attendant.

9. Un seul bug par rapport

Si vous avez trouvé trois problèmes sur la même page, rédigez trois rapports. Chacun pourra alors être assigné, corrigé, testé et clôturé séparément. Liez-les s’ils semblent liés.

10. Restez disponible

Après l’envoi, surveillez le ticket au cas où des questions arrivent. Quand la correction est livrée, retestez avec les mêmes étapes et confirmez. Si le bug revient plus tard, rouvrez le ticket d’origine ou faites-y référence, pour que l’historique reste au même endroit.

Erreurs courantes

  • Des titres vagues comme « ne marche pas » ou « problème sur la page ».
  • Des étapes manquantes, ou des étapes qui commencent au milieu d’un parcours.
  • Des captures d’écran de messages d’erreur au lieu du texte, impossibles à rechercher.
  • Plusieurs bugs dans un seul ticket.
  • De vrais secrets dans le rapport : mots de passe, clés d’API, cookies de session ou données clients dans les captures d’écran et les logs.
  • Un ton émotionnel. Un rapport calme et factuel est corrigé plus vite qu’un rapport en colère.

Pour comparer de bons et de mauvais rapports côte à côte, voir nos exemples de rapports de bug.

Écrire moins, capturer plus

L’essentiel de l’effort d’un rapport de bug porte sur les détails techniques, et ce sont aussi ceux que les gens oublient. Midge, une extension Chrome gratuite, enregistre votre écran ou prend une capture d’écran et joint ces détails pour vous : vous n’écrivez plus que le titre, les étapes et ce que vous attendiez. Chaque enregistrement contient les logs console, les requêtes réseau, les actions utilisateur et les infos sur l’appareil. 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. Le rapport se partage sous forme d’un seul lien, que vous pouvez coller dans l’outil de suivi qu’utilise votre équipe.

Guides associés

Questions fréquentes

Quelles sont les parties les plus importantes d’un rapport de bug ?

Les étapes de reproduction, le résultat attendu et le résultat obtenu. Avec ces trois éléments, un développeur peut généralement voir le problème par lui-même. Les détails d’environnement et les preuves comme les captures d’écran et les erreurs console accélèrent les choses.

Quelle longueur doit faire un rapport de bug ?

Aussi court que possible tout en restant complet. La plupart des bons rapports tiennent sur un écran : un titre d’une ligne, un court résumé, cinq à dix étapes, les résultats attendu et obtenu, et les pièces jointes.

Et si je n’arrive pas à reproduire le bug ?

Signalez-le quand même, en le précisant. Décrivez exactement ce que vous faisiez, quand c’est arrivé, et joignez toutes les preuves dont vous disposez, comme une capture d’écran ou une erreur console. Indiquez comme fréquence « arrivé une seule fois ».

Dois-je donner mon avis sur la cause ?

Séparez les observations des suppositions. Écrivez ce que vous avez vu dans les champs principaux et, si vous avez une hypothèse, ajoutez-la dans une section de notes en la présentant comme une supposition.