Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onrejectionhandled — tratamento posterior de uma rejeição de Promise

O atributo body onrejectionhandled regista um processador para o evento rejectionhandled de Window: uma rejeição de Promise anteriormente não tratada recebeu posteriormente um processador.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<body onrejectionhandled="handler(event)">
window.onrejectionhandled = handler;

onrejectionhandled em body é um atributo processador de eventos para Window, não um evento normal próprio do elemento. A propriedade correspondente é window.onrejectionhandled.

O evento rejectionhandled ocorre quando uma rejeição anteriormente assinalada como não tratada recebe posteriormente um processador. event.promise identifica a promise e event.reason contém o motivo da rejeição. Registar este processador de eventos não trata, por si só, a rejeição; a promise tem de ser tratada, por exemplo, com .catch().

O exemplo aguarda por unhandledrejection e, em seguida, associa .catch() numa tarefa posterior. preventDefault() suprime a comunicação predefinida do primeiro evento, mas não trata a promise. A página deverá apresentar handled: demo.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>rejectionhandled demo</title>
<body onrejectionhandled="if (event.promise === window.demoPromise) document.getElementById('result').textContent = 'handled: ' + event.reason">
<pre id="result">waiting</pre>
<script>
window.addEventListener('unhandledrejection', (event) => {
  if (event.promise !== window.demoPromise) return;
  event.preventDefault();
  setTimeout(() => {
    event.promise.catch(() => {});
  }, 0);
});
window.demoPromise = Promise.reject('demo');
</script>
</body>

Resultado

handled: demo

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes