WorkerGlobalScope: rejectionhandled Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

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

Das rejectionhandled Ereignis wird an den globalen Skript-Bereich (typischerweise WorkerGlobalScope) gesendet, wann immer ein abgelehntes Promise verspätet behandelt wird, d.h. wenn ein Handler an das Promise angehängt wird, nachdem seine Ablehnung ein unhandledrejection Ereignis ausgelöst hatte.

Dies kann beim Debuggen und für die allgemeine Anwendungsresilienz verwendet werden, in Kombination mit dem unhandledrejection Ereignis, das gesendet wird, wenn ein Promise abgelehnt wird, aber zum Zeitpunkt der Ablehnung kein Handler vorhanden ist.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("rejectionhandled", (event) => { })

onrejectionhandled = (event) => { }

Ereignistyp

Ein PromiseRejectionEvent. Erbt von Event.

Ereigniseigenschaften

PromiseRejectionEvent.promise Schreibgeschützt: Das abgelehnte Promise.
PromiseRejectionEvent.reason Schreibgeschützt: Ein Wert oder Object, der angibt, warum das Promise abgelehnt wurde, wie es an Promise.reject() übergeben wurde.

Beispiel

Sie können das rejectionhandled Ereignis verwenden, um Promise-Ablehnungen und die Gründe dafür in der Konsole zu protokollieren:

self.addEventListener("rejectionhandled", (event) => {
  console.log(`Promise rejected; reason: ${event.reason}`);
});

Spezifikationen

Specification
HTML # handler-workerglobalscope-onrejectionhandled