TaskSignal: any() statische Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die TaskSignal.any() statische Methode nimmt ein iterierbares Objekt von AbortSignal-Objekten und gibt ein TaskSignal zurück. Das zurückgegebene Task-Signal wird abgebrochen, wenn eines der Abbruchsignale abgebrochen wird.

Wenn das Task-Signal abgebrochen wird, wird seine reason-Eigenschaft auf den Grund des ersten abgebrochenen Signals gesetzt.

Syntax

js
TaskSignal.any(signals)
TaskSignal.any(signals, init)

Parameter

signals

Ein iterierbares Objekt (wie ein Array) von Abbruchsignalen.

init Optional

Enthält optionale Konfigurationsparameter. Derzeit ist nur eine Eigenschaft definiert:

priority Optional

Eine der folgenden Optionen:

  • Ein String, der entweder user-blocking, user-visible oder background ist.
  • Ein TaskSignal.

Rückgabewert

Eine TaskSignal-Instanz. Sie wird abgebrochen, wenn das erste Signal in signals abgebrochen wird. Wenn dies geschieht:

  • Ihre reason-Eigenschaft wird auf den Grund des Signals gesetzt, das dieses Signal zum Abbruch gebracht hat.

  • Ihre priority-Eigenschaft wird durch den priority-Parameter bestimmt:

    • Wenn der priority-Parameter ein String war, wird er den Wert des Strings haben.
    • Wenn der priority-Parameter ein TaskSignal war, wird er den Wert der priority dieses Signals haben.

Beispiele

Verwendung von TaskSignal.any()

Dieses Beispiel demonstriert die Kombination sowohl eines Signals von einem TaskController als auch eines Timeout-Signals von TaskSignal.timeout().

js
const cancelDownloadButton = document.getElementById("cancelDownloadButton");

const userCancelController = new TaskController({
  priority: "user-visible",
});

cancelDownloadButton.addEventListener("click", () => {
  userCancelController.abort();
});

// Timeout after 5 minutes
const timeoutSignal = TaskSignal.timeout(1_000 * 60 * 5);

// This signal will abort when either the user clicks the cancel button or 5 minutes is up whichever is sooner
const combinedSignal = TaskSignal.any([
  userCancelController.signal,
  timeoutSignal,
]);

try {
  const res = await fetch(someUrlToDownload, {
    // Stop the fetch when any of the
    signal: combinedSignal,
  });
  const body = await res.blob();
  // Do something with downloaded content
  // …
} catch (e) {
  if (e.name === "AbortError") {
    // Cancelled by the user
  } else if (e.name === "TimeoutError") {
    // Show user that download timed out
  } else {
    // Other error, e.g. network error
  }
}

Spezifikationen

Specification
Prioritized Task Scheduling
# dom-tasksignal-any

Browser-Kompatibilität

Siehe auch