Ratgeber: Eine fehlgeschlagene Anfrage ist keine leere Trefferliste

Keine Treffer und keine Antwort unterscheiden

Eine Suche ohne passende Ergebnisse braucht eine andere Meldung als eine Suche, deren Server gerade nicht antwortet. Werden beide Fälle als „Nichts gefunden“ dargestellt, ändern Nutzer möglicherweise ihre Eingabe, obwohl das Problem woanders liegt. Die MDN-Anleitung zur Fetch API erklärt einen dafür wichtigen technischen Unterschied: fetch verwirft sein Promise nicht allein wegen eines HTTP-Fehlerstatus wie 404. Der Status muss ausdrücklich geprüft werden. Dieser Fachratgeber verwendet die am 9. Oktober 2026 gelesene Dokumentation und beschreibt bestehende Technik, keine aktuelle Produktankündigung.

Vier Testantworten vorbereiten

Entwirf für eine eigene Vereinsartikelsuche vier kontrollierte Antworten. Die erste enthält zwei Treffer, die zweite eine gültige leere Liste, die dritte einen Fehlerstatus und die vierte einen Inhalt, der nicht als das erwartete JSON gelesen werden kann. Notiere für jeden Fall die passende sichtbare Reaktion. Nur die gültige leere Liste rechtfertigt die Aussage, dass keine passenden Artikel vorhanden sind. Bei einer technischen Störung sollte die Eingabe erhalten bleiben, damit ein erneuter Versuch möglich ist. Verwende dafür eine lokale Testumgebung und keine absichtlich beschädigten Produktivendpunkte.

Erfolg erst nach den nötigen Prüfungen anzeigen

Ein brauchbarer Entwicklungsauftrag trennt HTTP-Status, lesbares Datenformat und fachlich erwartete Struktur. MDN zeigt die Statusprüfung über response.ok und das anschließende asynchrone Lesen des Inhalts. Für unser Beispiel kommt danach die eigene Regel hinzu, dass die Antwort eine Trefferliste enthalten muss. Eine formal lesbare Zahl wäre hier noch kein brauchbares Suchergebnis. Schreibe auch auf, welche technische Einzelheit Nutzer wirklich benötigen: meist eine verständliche Störungsmeldung und ein nächster Schritt, nicht eine rohe Fehlermeldung mit internen Serverpfaden.

Wiederholen ohne Verlust testen

Lass zunächst die Fehlerantwort erscheinen und danach eine erfolgreiche Antwort mit denselben Suchwörtern. Der erneute Versuch sollte die Eingabe behalten und den alten Fehlerzustand ersetzen. Prüfe zusätzlich eine schmale Ansicht mit einer langen Suchphrase. Eingabefeld, Meldung und Wiederholen-Schaltfläche müssen zusammen verständlich bleiben. Ein weiterer Gegenfall ist eine erfolgreiche Anfrage ohne Treffer: Dort soll kein technischer Alarm stehen. Mit diesen vier gezielten Antworten kannst du später überprüfen, ob die Oberfläche ehrlich über ihren Zustand informiert, anstatt unterschiedliche Ursachen hinter einem einzigen leeren Bildschirm zu verstecken.