Les étapes de reproduction sont les actions numérotées qui mènent quelqu'un d'autre d'un point de départ connu jusqu'au bug que vous avez vu. De bonnes étapes disent d'où vous êtes parti (la page, le compte, le contenu du panier), donnent une action par ligne avec les valeurs exactes que vous avez saisies, et se terminent par ce que vous attendiez et ce qui s'est passé à la place.
Le rapport tel qu'il arrive
Maya Thompson fait ses achats sur Acme Store, la boutique de démonstration que j'utilise pour mes captures d'écran. Maya et la boutique sont fictives, et son bug est celui de l'article sur Whisper. Cette fois, il s'agit des étapes. Elle saisit FALL20 dans le champ du code promo, le total devient $NaN, et elle envoie ceci avec le bouton de signalement de bug de la boutique :
Applied FALL20 and the total turned into "$NaN". Shipping still says Free and I can't continue to payment.
(J'ai appliqué FALL20 et le total est devenu « $NaN ». La livraison indique toujours Free et je ne peux pas passer au paiement.)

Venant d'une cliente, c'est un bon rapport. Il cite le code, le symptôme et ce qui est bloqué. Sur la machine d'un développeur, où l'API de livraison répond, FALL20 donne le bon total.
Le même bug sous forme d'étapes
Des étapes qu'un développeur peut suivre partent d'un état qu'il peut recréer :
Départ : https://acme-store.com/cart, connecté en tant que client cus_1042
Panier : 2 × Enamel camp mug, 1 × Canvas market tote, 1 × Merino rib beanie
Adresse : Portland, OR 97205
1. Cliquer sur + à côté de Canvas market tote. La quantité passe à 2.
2. Saisir FALL20 dans Discount code.
3. Cliquer sur Apply.
Attendu : Discount −$23.20, total $92.80.
Obtenu : Discount −$23.20, total "$NaN". Shipping indique toujours Free.
Continue to payment ne fait rien.
Navigateur : Chrome 141 sur macOS, fenêtre 1280 × 800
Fréquence : à chaque essai
Le rôle de chaque partie :
Un état de départ qu'une autre personne peut recréer. « Un panier avec quelques articles » n'en est pas un.
Toutes les actions y sont, même celle qui semble hors sujet. Maya a modifié la quantité du cabas avant d'appliquer le code. Ici, ça n'a rien changé, mais le développeur ne pouvait pas le savoir sans essayer.
Une action par étape, qui commence par le verbe : cliquer, saisir, sélectionner, faire défiler.
Des valeurs exactes, parce que FALL20 et « un code promo » sont deux entrées différentes. Un code retire 20 %, un autre retire 10 $, et il se peut qu'un seul des deux casse quelque chose.
Les libellés tels que la page les affiche : Discount code, Apply, Continue to payment. Le développeur cherche ces chaînes dans le code.
Le résultat attendu sous forme de nombre. « Le bon total » oblige le développeur à le calculer d'abord, alors que $92.80 se vérifie d'un coup d'œil.
Le navigateur, le système d'exploitation et la taille de la fenêtre, car un bug de mise en page à 1280 pixels peut ne pas exister à 1440.
La fréquence : à chaque fois, une fois sur cinq, une seule fois.
Tout ce que vous avez vu en chemin : un message d'erreur, une roue de chargement qui tournait sans fin.
La précondition que la cliente ne pouvait pas voir
Sur une machine où l'API de livraison répond, ces étapes donnent $92.80.
Quand Maya a cliqué sur Apply, la boutique a demandé un nouveau tarif à son API de livraison. L'API a répondu 503 au bout de 1,2 seconde avec carrier_timeout au lieu des tarifs, et la page a ajouté au total un montant de livraison indéfini. La première ligne des étapes est donc une précondition : l'endpoint des tarifs de livraison répond par une erreur, ici une 503. Une cliente ne peut pas écrire ça : la ligne Shipping affiche toujours Free, et rien sur la page ne mentionne la requête en échec.
Les étapes doivent comporter une ligne de précondition pour tout état que l'auteur du rapport ne contrôle pas : réponses du serveur, feature flags, données du compte.
BugDump enregistre les étapes au fil des clics de la cliente
Dans BugDump, c'est le widget qui enregistre les étapes. Chaque rapport envoyé par le widget contient une liste Actions : clics, valeurs saisies, cases cochées ou décochées, options choisies, formulaires envoyés et changements de page, dans l'ordre. Voici celle de Maya :

Six lignes correspondent aux étapes ci-dessus, y compris le clic sur le cabas dont elle n'a jamais parlé. Comment fonctionne la liste :
Elle nomme des éléments, pas des libellés. La première ligne,
Clicked <button type="button">, est le + à côté du cabas. La relecture de session du même rapport montre de quel bouton il s'agit.Elle masque les champs sensibles. Les champs de mot de passe, les champs dont l'attribut
autocompletedésigne un numéro de carte, une date d'expiration, un code de sécurité ou un code à usage unique, et tout ce qui se trouve dansdata-bugdump-maskou.bugdump-blockapparaissent comme Typed (hidden), c'est-à-dire saisie masquée. Un champ de carte sans cetautocompleteest enregistré comme n'importe quel autre. Les autres valeurs saisies sont coupées à 80 caractères.Elle garde les 500 dernières actions, ou 3 000 pendant que l'auteur du rapport enregistre son écran.
La précondition se trouve dans le même rapport. L'onglet Network contient la 503 de /api/shipping/rates, et l'onglet Console la ligne d'erreur que la boutique écrit elle-même à ce sujet. La boutique a activé la capture des corps de requête et de réponse, donc l'onglet montre aussi carrier_timeout. Cette capture est désactivée par défaut, et sans elle l'onglet montre quand même la 503 et sa durée.
Avec ces éléments, le développeur écrit la première ligne : l'endpoint des tarifs répond 503. Avec un mock ou une règle de proxy qui renvoie cette réponse, les étapes 1 à 3 donnent $NaN à chaque fois. Bloquer la requête ne suffit pas : une requête qui ne reçoit aucune réponse laisse le total à $92.80.
Questions fréquentes sur les étapes de reproduction
Les étapes de reproduction, est-ce la même chose qu'un rapport de bug ? Non, ce n'en est qu'une partie. Un rapport de bug contient aussi un titre et les preuves : captures d'écran, console, réseau.
Combien d'étapes faut-il ? Le moins possible, tant qu'elles mènent du départ jusqu'au bug. Partez de la page la plus proche du bug qu'une autre personne puisse ouvrir directement : chaque étape avant elle est une étape de plus qui peut se dérouler autrement.
Et si je n'arrive pas à le reproduire moi-même ? Notez ce que vous avez fait, précisez que c'est arrivé une fois, et joignez la console et le réseau de ce moment-là.
Pour aller plus loin
Comment rédiger un bon rapport de bug (avec checklist) : tout le rapport autour des étapes, du titre jusqu'aux preuves.
Que faire d'un rapport de bug impossible à reproduire : quand les étapes sont justes et que le bug refuse toujours d'apparaître.
La relecture de session pour voir ce que l'utilisateur a fait avant le bug : ce que la relecture apporte quand la liste d'actions dit
<button>et qu'il faut voir lequel.
