Inhalt der Anleitung
Eine Meldung wie „Etwas ist kaputt“ lässt dem Agenten zu vieles offen. Eine brauchbare Aufgabe enthält die Schritte zur Reproduktion, das tatsächliche Ergebnis und das erwartete Verhalten. Wir gehen das an einer kleinen Funktion durch, die den Bestellwert mit Rabatt berechnet.
Was Sie vorbereiten
- Laden Sie das Übungsbeispiel herunter: Es enthält eine JavaScript-Funktion, die Fehlerbeschreibung und Kontrollwerte.
- Für Ihr eigenes Projekt stellen Sie das passende Repository oder die Dateien bereit, dazu den Startbefehl und die Grenzen für Änderungen.
- Beschreiben Sie die Reproduktion so, dass eine andere Person denselben Fehler auslösen kann.
Die Quelldateien enthalten Übungsdaten. Ersetzen Sie sie durch Ihre eigenen, sobald Sie den Ablauf beherrschen.
Das Problem bestätigen lassen
Zuerst soll Octodus das Ausgangsszenario prüfen. Im Übungsbeispiel bedeutet ein Rabatt von 10 zehn Prozent, die Funktion behandelt den Wert aber als fertigen Anteil. Das tatsächliche Ergebnis weicht vom erwarteten ab.
Wenn sich Code nicht ausführen lässt, bitten Sie ausdrücklich darum, Analyse und tatsächlichen Lauf zu trennen. Eine Vermutung über das Verhalten ist kein Ergebnis einer wirklich ausgeführten Prüfung.
Im angehängten Übungsbeispiel wird der Betrag nach Rabatt falsch berechnet. Reproduziere den Fehler mit den angegebenen Eingabewerten. Erkläre die Ursache und nimm dann eine minimale Korrektur vor. Erweitere die Aufgabe nicht um neue Funktionen. Wenn sich der Code nicht ausführen ließ, weise ausdrücklich darauf hin.
Ausgangsfall und Nachbarfälle prüfen
Nach der Korrektur berechnen Sie den Betrag für die Bestellung, die zuvor falsch war, noch einmal. Prüfen Sie danach null Prozent Rabatt, vollen Rabatt und einen Betrag mit Cent.
In einem echten Projekt führen Sie zusätzlich die vorhandenen Tests aus. Lassen Sie auflisten, was ausgeführt wurde und was ungeprüft bleibt. So können Sie besser einschätzen, wie einsatzbereit die Änderung wirklich ist.
Prüfe die korrigierte Funktion anhand aller Kontrollbeispiele aus der Datei. Zeige Eingabe, erwartetes und tatsächliches Ergebnis. Erkläre die Änderung im Code und nenne die Einschränkungen, die diese Übungsfunktion nicht abdeckt.
Beispielergebnis
Kontrollwerte
- Eine Bestellung über 2.000 € mit 10 % Rabatt muss 1.800 € ergeben.
- Eine Bestellung über 2.000 € ohne Rabatt bleibt bei 2.000 €; mit 100 % Rabatt sind es 0 €.
- Eine Bestellung über 199,90 € mit 15 % Rabatt ergibt 169,92 €, auf Cent gerundet.
Der wichtigste Punkt und die Prüfung
Geänderter Code und ein erfolgreicher Build beweisen die Korrektur noch nicht. Entscheidend ist, dass das Szenario geprüft wird, das zuvor fehlschlug. Bei Geldbeträgen in einem echten Produkt legt man Rundungsregeln und die Darstellung der Beträge gesondert fest; die Übungsfunktion ersetzt diesen Teil der Konzeption nicht.
Bevor Sie das Ergebnis verwenden
- Die Ursache passt zum beobachteten Verhalten.
- Das Ausgangsszenario liefert nach der Korrektur das erwartete Ergebnis.
- Die in der Aufgabe genannten Randfälle wurden geprüft.
- Aus dem Bericht geht hervor, welche Prüfungen gelaufen sind und welche nicht.
So wiederholen Sie das bei Ihrer eigenen Aufgabe
Behalten Sie das Format der Aufgabe bei: Kontext, Reproduktion, Erwartung, Grenzen der Änderung und Prüfung. Es eignet sich gut für die nächsten Fehler. Wenn Sie einen eigenen kleinen Service hosten möchten, gehen Sie zur Octo-Cloud-Anleitung mit Postgres über.
Probieren Sie dieses Szenario aus
Laden Sie die Quelldatei herunter, kopieren Sie die Aufgabe und senden Sie sie zusammen mit der Datei an Octodus.