WorkerGlobalScope: unhandledrejection event

Syntax

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

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

onunhandledrejection = (event) => { }

Ereignistyp

Ein PromiseRejectionEvent. Erbt von Event.

Ereigniseigenschaften

PromiseRejectionEvent.promise Schreibgeschützt

Das JavaScript Promise, das abgelehnt wurde.

PromiseRejectionEvent.reason Schreibgeschützt

Ein Wert oder Object, der angibt, warum das Versprechen abgelehnt wurde, wie es an Promise.reject() übergeben wurde.

Beispiele

Grundlegende Fehlerprotokollierung

Dieses Beispiel protokolliert Informationen über die unbehandelte Promise-Ablehnung in der Konsole.

self.addEventListener("unhandledrejection", (event) => {
  console.warn(`UNHANDLED PROMISE REJECTION: ${event.reason}`);
});

Sie können auch die onunhandledrejection Ereignis-Handler-Eigenschaft verwenden, um den Ereignis-Listener einzurichten:

self.onunhandledrejection = (event) => {
  console.warn(`UNHANDLED PROMISE REJECTION: ${event.reason}`);
};

Standardbehandlung verhindern

Viele Umgebungen (wie Node.js) melden unbehandelte Promise-Ablehnungen standardmäßig in der Konsole. Sie können dies verhindern, indem Sie einen Handler für unhandledrejection Ereignisse hinzufügen, der – zusätzlich zu allen anderen Aufgaben, die Sie ausführen möchten – preventDefault() aufruft, um das Ereignis zu stornieren und zu verhindern, dass es zur Laufzeit an das Protokollierungscode weitergegeben wird. Dies funktioniert, da unhandledrejection abbrechbar ist.

self.addEventListener("unhandledrejection", (event) => {
  // code for handling the unhandled rejection
  // …

  // Prevent the default handling (such as outputting the
  // error to the console)

  event.preventDefault();
});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Promise-Ablehnungsereignisse
• PromiseRejectionEvent
• Promise
• rejectionhandled Ereignis