Schritte zur Reproduktion sind die nummerierten Aktionen, mit denen jemand anderes von einem bekannten Ausgangspunkt zu dem Bug kommt, den du gesehen hast. Gute Schritte nennen, wo du angefangen hast (die Seite, das Konto, was im Warenkorb lag), enthalten eine Aktion pro Zeile mit den exakten Werten, die du eingegeben hast, und enden mit dem, was du erwartet hast, und dem, was stattdessen passiert ist.
Der Bericht, wie er ankommt
Maya Thompson kauft bei Acme Store ein, dem Demo-Shop, den ich für Screenshots nutze. Sie und der Shop sind erfunden, und ihr Bug ist derselbe wie im Beitrag über Whisper. Hier geht es um die Schritte. Sie gibt FALL20 ins Rabattfeld ein, die Summe wird zu $NaN, und sie schickt über den Button für Fehlerberichte im Shop diesen Text:
Applied FALL20 and the total turned into "$NaN". Shipping still says Free and I can't continue to payment.
(Auf Deutsch: FALL20 eingelöst, und die Summe wurde zu „$NaN“. Bei Shipping steht immer noch Free, und ich komme nicht weiter zur Zahlung.)

Von Kundenseite ist das ein guter Bericht. Er nennt den Code, das Symptom und was dadurch blockiert ist. Auf einem Entwicklungsrechner, auf dem die Versand-API antwortet, ergibt FALL20 die richtige Summe.
Derselbe Bug als Schritte
Schritte, denen das Entwicklungsteam folgen kann, beginnen bei einem Zustand, den es nachbauen kann:
Start: https://acme-store.com/cart, angemeldet mit dem Kundenkonto cus_1042
Warenkorb: 2 × Enamel camp mug, 1 × Canvas market tote, 1 × Merino rib beanie
Versand an: Portland, OR 97205
1. Klicke auf + neben Canvas market tote. Die Menge steigt auf 2.
2. Gib FALL20 in Discount code ein.
3. Klicke auf Apply.
Erwartet: Discount −$23.20, Summe $92.80.
Tatsächlich: Discount −$23.20, Summe „$NaN“. Bei Shipping steht weiter Free.
Continue to payment reagiert nicht.
Browser: Chrome 141 unter macOS, Fenster 1280 × 800
Wie oft: bei jedem Versuch
Wozu die einzelnen Teile da sind:
Den Ausgangszustand kann jemand anderes nachbauen. „Ein Warenkorb mit ein paar Sachen“ kann niemand nachbauen.
Jede Aktion steht drin, auch eine, die nebensächlich wirkt. Maya hat die Menge der Tasche geändert, bevor sie den Code eingelöst hat. Hier spielte das keine Rolle, aber ohne Ausprobieren konnte das Entwicklungsteam das nicht wissen.
Eine Aktion pro Schritt, vorne das Verb: klicken, eingeben, auswählen, scrollen.
Exakte Werte, denn FALL20 und „ein Gutschein“ sind verschiedene Eingaben. Ein Code zieht 20 % ab, ein anderer 10 $, und den Fehler löst vielleicht nur einer davon aus.
Beschriftungen so, wie die Seite sie zeigt: Discount code, Apply, Continue to payment. Das Entwicklungsteam sucht im Code genau nach diesen Strings.
Das erwartete Ergebnis als Zahl. Bei „die richtige Summe“ muss das Entwicklungsteam sie erst ausrechnen, $92.80 lässt sich auf einen Blick prüfen.
Browser, Betriebssystem und Fenstergröße, denn ein Layoutfehler bei 1280 Pixeln tritt bei 1440 vielleicht gar nicht auf.
Wie oft: jedes Mal, bei einem von fünf Versuchen, einmal.
Alles, was dir unterwegs aufgefallen ist: eine Fehlermeldung, ein Ladekreisel, der nicht mehr aufhörte.
Die Vorbedingung, die für die Kundin unsichtbar war
Auf einem Rechner, auf dem die Versand-API antwortet, ergeben diese Schritte $92.80.
Als Maya auf Apply klickte, fragte der Shop bei seiner Versand-API neue Versandkosten an. Die API antwortete nach 1,2 Sekunden mit 503 und carrier_timeout statt mit Versandkosten, und die Seite addierte einen undefinierten Versandbetrag zur Summe. Die erste Zeile der Schritte ist deshalb eine Vorbedingung: Der Endpunkt für Versandkosten antwortet mit einem Fehler, hier mit 503. Das kann niemand aus der Kundschaft aufschreiben: In der Zeile Shipping steht weiter Free, und nichts auf der Seite erwähnt den fehlgeschlagenen Request.
Für einen Zustand, auf den man beim Melden keinen Einfluss hat, brauchen Schritte eine Zeile mit der Vorbedingung: Antworten des Servers, Feature-Flags, die Daten des Kontos.
BugDump schreibt die Schritte mit, während die Kundschaft klickt
In BugDump zeichnet das Widget die Schritte selbst auf. Jeder Bericht, den das Widget sendet, enthält eine Liste Actions: Klicks, eingegebene Werte, Umschalter, ausgewählte Optionen, abgeschickte Formulare und Seitenwechsel, in ihrer Reihenfolge. Das ist Mayas Liste:

Sechs Zeilen entsprechen den Schritten oben, auch der Klick bei der Tasche, den sie nie erwähnt hat. So funktioniert die Liste:
Sie nennt Elemente, keine Beschriftungen. Die erste Zeile,
Clicked <button type="button">, ist das + neben der Tasche. Welcher Button es war, zeigt das Session-Replay im selben Bericht.Sie verbirgt sensible Felder. Passwortfelder, Felder, deren
autocompleteeine Kartennummer, ein Ablaufdatum, einen Sicherheitscode oder einen Einmalcode kennzeichnet, und alles innerhalb vondata-bugdump-maskoder.bugdump-blockerscheinen als Typed (hidden). Ein Kartenfeld ohne diesesautocompletewird wie jedes andere aufgezeichnet. Andere eingegebene Werte werden nach 80 Zeichen abgeschnitten.Sie behält die letzten 500 Aktionen, während einer Bildschirmaufnahme 3.000.
Die Vorbedingung steht im selben Bericht. Im Tab Network steht der Status 503 von /api/shipping/rates, im Tab Console die Fehlerzeile, die der Shop selbst dazu geloggt hat. Der Shop hat die Bodies der Netzwerk-Requests eingeschaltet, deshalb zeigt der Tab auch carrier_timeout. Standardmäßig sind Bodies aus, und auch ohne sie zeigt der Tab den Status 503 und wie lange der Request gedauert hat.
Damit schreibt das Entwicklungsteam die erste Zeile: Der Endpunkt für Versandkosten antwortet mit 503. Mit einem Mock oder einer Proxy-Regel, die genau das zurückgibt, ergeben die Schritte 1 bis 3 jedes Mal $NaN. Den Request zu blockieren reicht nicht: Bekommt ein Request gar keine Antwort, bleibt die Summe bei $92.80.
Häufige Fragen zu Schritten zur Reproduktion
Sind Schritte zur Reproduktion dasselbe wie ein Fehlerbericht? Nein, sie sind ein Teil davon. Zu einem Fehlerbericht gehören außerdem ein Titel und die Belege: Screenshots, Console, Netzwerk.
Wie viele Schritte sollten es sein? So wenige, wie nötig sind, um vom Start zum Bug zu kommen. Fang auf der Seite an, die dem Bug am nächsten liegt und die jemand anderes direkt öffnen kann: Jeder Schritt davor ist ein weiterer Schritt, der anders verlaufen kann.
Und wenn ich den Bug selbst nicht reproduzieren kann? Schreib auf, was du getan hast, vermerke, dass es einmal passiert ist, und häng Console und Netzwerk von diesem Zeitpunkt an.
So schreibst du einen guten Fehlerbericht (mit Checkliste): der ganze Bericht rund um die Schritte, vom Titel bis zu den Belegen.
Was tun mit einem Fehlerbericht, den du nicht reproduzieren kannst: wenn die Schritte stimmen und der Bug trotzdem nicht auftaucht.
Session-Replay zum Debuggen: was vor dem Bug passiert ist: was das Replay ergänzt, wenn in der Aktionsliste nur
<button>steht und du sehen musst, welcher gemeint ist.
