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

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.

Fontes