Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onunhandledrejection — rechazo de promesa no gestionado

El atributo onunhandledrejection en body registra un controlador para el evento unhandledrejection del objeto Window. Permite acceder al motivo del rechazo de una promesa que aún no tiene un controlador de rechazo cuando se produce la notificación.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

onunhandledrejection es un atributo de controlador de eventos cuyo valor es código JavaScript. En body, establece el controlador del evento unhandledrejection del objeto Window, no el de un evento independiente del elemento. No es un atributo HTML global ordinario disponible en todos los elementos. Su equivalente en JavaScript es la propiedad window.onunhandledrejection.

La notificación es asíncrona. Si se añade un controlador de rechazo con suficiente antelación, el evento no se produce. El objeto event es un PromiseRejectionEvent: event.promise identifica la promesa rechazada y event.reason contiene el motivo del rechazo.

Llamar a event.preventDefault() cancela el informe predeterminado de este evento en la consola; no repara la promesa. Gestiona los errores previsibles en su origen, en lugar de depender únicamente de una notificación global.

El ejemplo establece el atributo en body y gestiona el rechazo de la promesa con promise.catch(() => {}). La llamada a window.dispatchEvent() despacha en window un evento unhandledrejection sintético y cancelable, lo que invoca al controlador que escribe event.reason en la consola. El ejemplo muestra que el controlador está conectado, no cómo notifica el navegador un rechazo no gestionado. Aquí, la llamada a event.preventDefault() solo afecta al evento sintético y no demuestra cómo suprimir el aviso predeterminado del navegador ante un rechazo no gestionado. El código inline requiere permiso según la política de seguridad de la página.

Ejemplos

<!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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes