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.