AbortSignal: timeout() statische Methode

Die statische Methode AbortSignal.timeout() gibt ein AbortSignal zurück, das nach einer angegebenen Zeit automatisch abbricht.

Das Signal bricht mit einem TimeoutError-DOMException bei einem Timeout ab oder mit einer AbortError-DOMException aufgrund des Drückens einer Stopptaste im Browser (oder einer anderen integrierten "Stopp"-Operation). Dies ermöglicht es Benutzeroberflächen, Timeout-Fehler, die typischerweise eine Benutzerbenachrichtigung erfordern, von nutzerbedingten Abbrüchen, die dies nicht erfordern, zu unterscheiden.

Der Timeout basiert auf aktiver statt auf vergangener Zeit und wird effektiv pausiert, wenn der Code in einem angehaltenen Worker ausgeführt wird oder während das Dokument im Rückwärts-Vorwärts-Cache ("bfcache") ist.

Um mehrere Signale zu kombinieren, können Sie AbortSignal.any() verwenden, um beispielsweise einen Download direkt mit einem Timeout-Signal oder durch Aufruf von AbortController.abort() abzubrechen.

AbortSignal.timeout(time)

const url = "https://path_to_large_file.mp4";

try {
  const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
  const result = await res.blob();
  // …
} catch (err) {
  if (err.name === "TimeoutError") {
    console.error("Timeout: It took more than 5 seconds to get the result!");
  } else if (err.name === "AbortError") {
    console.error(
      "Fetch aborted by user action (browser stop button, closing tab, etc.",
    );
  } else if (err.name === "TypeError") {
    console.error("AbortSignal.timeout() method is not supported");
  } else {
    // A network error, or some other problem.
    console.error(`Error: type: ${err.name}, message: ${err.message}`);
  }
}