Ratgeber: Mit AbortSignal.timeout eine abgebrochene Anfrage verständlich abschließen

Ein Ende des Wartens braucht eine Aussage

Eine Webseite lädt eine Vorschau aus einer öffentlichen Quelle. Nach längerer Wartezeit soll sie wieder bedienbar werden. Ein Timeout kann den Abruf begrenzen, liefert aber noch keinen erfolgreichen Inhalt. MDN beschreibt AbortSignal.timeout als Signal, das nach einer festgelegten aktiven Zeit abbricht. Für die Benutzeroberfläche folgt daraus eine eigene Aufgabe: Der Wartezustand muss sauber enden, ohne ein leeres Ergebnis als bestätigte Antwort auszugeben.

Die möglichen Ergebnisse vorher unterscheiden

Plane mindestens Erfolg, Zeitüberschreitung und einen anderen Fehler als getrennte Fälle. Eine Person kann einen Vorgang außerdem selbst abbrechen. Diese Situationen müssen nicht dieselbe Meldung erhalten. Bei einem erfolgreichen Abruf prüfst du zusätzlich, ob der erwartete Inhalt vorliegt. Die vorgeschlagene Meldung Vorschau konnte noch nicht geladen werden ist beispielsweise ehrlicher als Keine Daten vorhanden, wenn gar keine vollständige Antwort eingetroffen ist.

Die Dokumentation weist darauf hin, dass der Timeout auf aktiver Zeit beruht. Eine im Hintergrund angehaltene Seite kann deshalb anders wirken als eine durchgehend aktive Stoppuhr. Veröffentliche aus einem einzelnen Browserversuch keine allgemeine Aussage über eine garantierte Antwortzeit. Prüfe auch die Unterstützung der eingesetzten Methode in deiner Zielumgebung und behandle einen nicht unterstützten Aufruf als technischen Fehler.

Eine kleine Verzögerungsprobe bauen

Verwende für die Abnahme eine kontrollierte Testquelle. Lasse sie einmal rechtzeitig, einmal zu spät und einmal mit einem eindeutig fehlerhaften Ergebnis antworten. Beobachte, ob die Ladeanzeige in allen Fällen endet und ob ein Wiederholenknopf erneut genau einen sinnvollen Versuch startet. Der neue Versuch darf den alten Inhalt nicht unbemerkt als frischen Erfolg ausgeben. Für diese Probe sind keine großen Downloads nötig.

Die Grenze auch nach dem Abbruch behalten

Ein abgebrochener Clientabruf beweist nicht, dass ein entfernter Server jede begonnene Arbeit rückgängig gemacht hat. Wiederholungen mit möglichen Schreibwirkungen brauchen daher eine gesonderte serverseitige Planung. Der beschriebene Ablauf eignet sich zunächst für eine lesende Vorschau. Halte den gemessenen Testfall und seine Rahmenbedingungen fest. So entsteht eine nachvollziehbare Wartegrenze, ohne aus einer Abbruchfunktion ein Versprechen über das ganze Netz zu machen.