CKTIS / HTML
onunhandledrejection — rejeição de promessa não tratada
O atributo onunhandledrejection em body regista um processador para o evento unhandledrejection do objeto Window. Permite aceder ao motivo da rejeição de uma promessa que ainda não tem um processador de rejeição quando ocorre a notificação.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection é um atributo de processamento de eventos cujo valor é código JavaScript. Em body, define o processador do evento unhandledrejection do objeto Window, e não de um evento separado do elemento. Não é um atributo HTML global comum disponível em todos os elementos. O equivalente em JavaScript é a propriedade window.onunhandledrejection.
A notificação é assíncrona. Se for acrescentado um processador de rejeição a tempo, o evento não ocorre. O objeto event é um PromiseRejectionEvent: event.promise identifica a promessa rejeitada e event.reason contém o motivo da rejeição.
Chamar event.preventDefault() cancela a apresentação predefinida deste evento na consola; não corrige a promessa. Trata as falhas previsíveis na sua origem, em vez de depender apenas de uma notificação global.
O exemplo define o atributo em body e trata a rejeição da promessa com promise.catch(() => {}). A chamada a window.dispatchEvent() desencadeia em window um evento unhandledrejection sintético e cancelável, invocando assim o processador que escreve event.reason na consola. O exemplo mostra que o processador está associado ao evento, não como o navegador notifica uma rejeição não tratada. Aqui, a chamada a event.preventDefault() aplica-se apenas ao evento sintético e não demonstra como impedir a apresentação do aviso predefinido do navegador quando uma rejeição não é tratada. O código inline requer autorização ao abrigo da política de segurança da página.
Exemplos
<!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>Resultado
reason: 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.