Abschnitt 17 · Lektion 3
Fehlerfälle testen
Manche Eingaben soll eine Funktion ablehnen, und der Test dafür erwartet einen Fehler. Nur passt zu „irgendein Fehler“ auch der, den ein Tippfehler in der Funktion selbst auslöst.
assert.throws braucht eine zweite Angabe
assert.throws(fn) prüft, dass fn wirft, und sonst nichts.
import test from "node:test";
import assert from "node:assert/strict";
const PREISE = { 1: 499, 2: 1250 };
function ladePreis(id) {
if (!Number.isInteger(id)) {
throw new TypeError("id muss eine ganze Zahl sein");
}
// Tippfehler: die Tabelle heisst PREISE. Das wirft einen ReferenceError.
return preise[id];
}
test("ohne zweite Angabe zählt sogar der Tippfehler als Erfolg", () => {
assert.throws(() => ladePreis(1));
});
test("ohne zweite Angabe ist auch der echte Fall grün", () => {
assert.throws(() => ladePreis("x"));
});
test("mit TypeError fällt der Tippfehler auf", () => {
assert.throws(() => ladePreis(1), TypeError);
});
test("mit TypeError bleibt der echte Fall grün", () => {
assert.throws(() => ladePreis("x"), TypeError);
}); In ladePreis steht preise statt PREISE, und jeder Aufruf mit gültiger Kennung wirft deshalb
einen ReferenceError. Der erste Test erwartet bei einer gültigen Kennung einen Fehler und ist
grün. Das ist absurd. Gemerkt hat es der Test nicht, denn er hat nur nach irgendeinem Fehler
gefragt.
Mit TypeError als zweiter Angabe wird derselbe Test rot. Im Block der roten Tests steht dann, ein
TypeError wäre erwartet gewesen und gekommen ist ein ReferenceError, darunter
preise is not defined. Damit ist der Tippfehler gefunden.
Drei Formen der zweiten Angabe reichen hier.
- Eine Klasse, etwa
TypeErroroder eine eigene Fehlerklasse. Das ist der häufigste Fall. - Ein Objekt mit Eigenschaften, etwa
{ code: "keine_deckung" }. Geprüft wird jede Eigenschaft, die dasteht, und nur die. - Eine Prüffunktion, die
trueliefern muss, für alles, was komplizierter ist.
Der Meldungstext gehört nicht in die zweite Angabe, auch nicht als regulärer Ausdruck, den
assert.throws ebenfalls annimmt. Ein Test auf { message: "Die Deckung reicht nicht" } bricht,
sobald jemand die Meldung umformuliert, und nach einer Übersetzung ist er wertlos. Klasse und code
bleiben dagegen stehen, so wie err.code beim Dateisystem.
assert.rejects und das await davor
Für abgelehnte Promises gibt es assert.rejects. Es sieht aus wie assert.throws, liefert aber
selbst ein Promise.
import test from "node:test";
import assert from "node:assert/strict";
async function ladeKonto(id) {
if (id !== 1) throw new Error("gibt es nicht");
return { id, stand: 100 };
}
test("ohne await bekommt der Test trotzdem seinen Haken", () => {
// ladeKonto(1) lehnt gar nicht ab, und trotzdem ist der Test gruen.
assert.rejects(() => ladeKonto(1), Error);
});
test("mit await fällt genau das auf", async () => {
await assert.rejects(() => ladeKonto(1), Error);
}); Beide Tests behaupten, dass ladeKonto(1) ablehnt. Das tut es aber nicht, es liefert ein Konto. Der
erste bekommt trotzdem seinen Haken. Ohne await ist die Testfunktion fertig, bevor
assert.rejects zu einem Ergebnis kommt, wie beim vergessenen await im vorigen Abschnitt. Die
Prüfung läuft danach noch zu Ende, nur gehört sie zu keinem Test mehr.
Node schreibt dazu eine eigene Zeile zwischen die Testliste und die Bilanz. Sie fängt mit
ℹ Error: Test, dem Namen des Tests und seiner Zeile an. Dann kommt
generated asynchronous activity after the test ended, der Test hat also nach seinem Ende noch
etwas angestoßen. Was dabei herauskam, steht dahinter. Missing expected rejection (Error). heißt,
die erwartete Ablehnung fehlt. Der Exit-Code wird 1, aber in der Bilanz zählt der Test trotzdem bei
pass.
So eine Zeile übersieht man zwischen den Haken leicht. Lehnt die Funktion ab, wie sie soll, kommt sie gar nicht, und dann stimmt der Haken, ohne dass der Test etwas dazu beigetragen hat.
Mit await davor und einer async-Testfunktion wartet der Test, bis die Prüfung fertig ist. Der
zweite Test im Beispiel wird so rot, und Missing expected rejection (Error). steht dort, wo es
hingehört, im Block der roten Tests. Dasselbe await braucht jeder Aufruf im Test, der ein Promise
liefert.
Attrappen mit mock
Manche Fehlerfälle lassen sich im Test nicht herstellen. Der Zahlungsdienst antwortet nicht, oder
die Mail geht nicht raus. Für solche Fälle bringt node:test mock mit.
import { test, mock } from "node:test";
import assert from "node:assert/strict";
// Eine Abhaengigkeit, die im Test nicht wirklich laufen soll.
const dienst = {
schickeMail(an, text) {
throw new Error("würde wirklich eine Mail verschicken");
},
};
function bestellen(dienst, kunde) {
dienst.schickeMail(kunde, "Danke für deine Bestellung");
return { status: "angelegt" };
}
test("verschickt genau eine Mail an den Kunden", () => {
const attrappe = mock.method(dienst, "schickeMail", () => undefined);
const ergebnis = bestellen(dienst, "kundin@example.com");
assert.equal(ergebnis.status, "angelegt");
assert.equal(attrappe.mock.callCount(), 1);
assert.deepEqual(attrappe.mock.calls[0].arguments, [
"kundin@example.com",
"Danke für deine Bestellung",
]);
attrappe.mock.restore();
}); mock.method(objekt, "name", ersatz) tauscht eine Methode aus und zeichnet dabei auf, wie sie
aufgerufen wurde. Die Attrappe weiß danach, wie oft sie dran war (callCount()) und womit
(calls[0].arguments), und beides lässt sich prüfen.
Für einen Fehlerfall wirft der Ersatz, statt undefined zu liefern. Dann siehst du im Test, was die
eigene Funktion tut, wenn der Dienst nicht mitspielt.
restore() gibt das Original zurück. Vergisst du es, ändert sich das Verhalten der folgenden Tests,
und du bist wieder beim geteilten Zustand aus der vorigen Lektion.
Jede Attrappe ist eine Annahme darüber, wie sich das Original verhält, und diese Annahme prüft niemand, selbst wenn der echte Dienst längst etwas anderes antwortet. Wer zu viel ersetzt, testet am Ende nur noch seine eigenen Attrappen. Ich ersetze nur, was nach draußen geht, also Netz, Mail, Zahlung und Uhrzeit, und nehme für alles andere die echte Sache.
konto.js aus der Aufgabe lehnt auf vier Arten ab, zweimal davon asynchron.
Zum Mitnehmen
assert.throws und assert.rejects bekommen als zweite Angabe die Fehlerklasse oder den code, nie den Meldungstext. Vor assert.rejects steht ein await, sonst ist der Test fertig, bevor geprüft ist.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.