Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onunhandledrejection — rifiuto di una promise non gestito

L’attributo onunhandledrejection su body registra un gestore per l’evento unhandledrejection dell’oggetto Window. Rende accessibile il motivo del rifiuto di una promise che, al momento della notifica, non ha ancora un gestore per il rifiuto.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<body onunhandledrejection="/* JavaScript using event */">

onunhandledrejection è un attributo gestore di eventi il cui valore è codice JavaScript. Su body imposta il gestore per l’evento unhandledrejection dell’oggetto Window, non per un evento separato dell’elemento. Non è un normale attributo HTML globale disponibile su ogni elemento. Il corrispettivo JavaScript è la proprietà window.onunhandledrejection.

La notifica è asincrona. Se si aggiunge per tempo un gestore del rifiuto, l’evento non si verifica. L’oggetto event è un PromiseRejectionEvent: event.promise identifica la promise rifiutata e event.reason contiene il motivo del rifiuto.

Chiamare event.preventDefault() annulla la segnalazione predefinita dell’evento nella console; non ripara la promise. Gestisci gli errori previsti alla loro origine, invece di affidarti soltanto a una notifica globale.

L’esempio imposta l’attributo su body e gestisce il rifiuto della promise con promise.catch(() => {}). La chiamata a window.dispatchEvent() genera su window un evento unhandledrejection sintetico e annullabile, invocando così il gestore che scrive event.reason nella console. L’esempio mostra che il gestore è collegato, non come il browser notifica un rifiuto non gestito. Qui la chiamata a event.preventDefault() riguarda solo l’evento sintetico e non dimostra come sopprimere la segnalazione predefinita del browser per un rifiuto non gestito. Il codice inline richiede l’autorizzazione prevista dalla politica di sicurezza della pagina.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Body onunhandledrejection handler</title>
</head>
<body onunhandledrejection="event.preventDefault(); console.log('reason: ' + event.reason)">
  <script>
    const reason = 'demo';
    const promise = Promise.reject(reason);
    // Handle the fixture so the browser does not report a real unhandled rejection.
    promise.catch(() => {});
    window.dispatchEvent(new PromiseRejectionEvent('unhandledrejection', {
      promise,
      reason,
      cancelable: true
    }));
  </script>
</body>
</html>

Risultato

reason: demo

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti