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

CKTIS / HTML

onrejectionhandled — gestionar posteriormente un rechazo de Promise

El atributo body onrejectionhandled registra un controlador para el evento rejectionhandled de Window: un rechazo de Promise que antes no estaba gestionado ha recibido posteriormente un controlador.

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

Sintaxis

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

onrejectionhandled en body es un atributo controlador de eventos para Window, no un evento ordinario propio del elemento. Su propiedad correspondiente es window.onrejectionhandled.

El evento rejectionhandled se produce cuando un rechazo notificado anteriormente como no gestionado recibe después un controlador. event.promise identifica la promesa y event.reason contiene el motivo del rechazo. Registrar este controlador de eventos no gestiona por sí mismo el rechazo; la promesa necesita gestionarse, por ejemplo, con .catch().

El ejemplo espera a unhandledrejection y luego añade .catch() en una tarea posterior. preventDefault() suprime la notificación predeterminada del primer evento, pero no gestiona la promesa. La página debería mostrar handled: demo.

Ejemplos

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

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