CKTIS / HTML
onrejectionhandled — traiter ultérieurement un rejet de Promise
L’attribut body onrejectionhandled enregistre un gestionnaire pour l’événement rejectionhandled de Window : un rejet de Promise auparavant non traité a ensuite reçu un gestionnaire.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onrejectionhandled="handler(event)">
window.onrejectionhandled = handler;onrejectionhandled sur body est un attribut de gestionnaire d’événement pour Window, et non un événement ordinaire propre à l’élément. La propriété correspondante est window.onrejectionhandled.
L’événement rejectionhandled se produit lorsqu’un rejet précédemment signalé comme non traité reçoit ensuite un gestionnaire. event.promise désigne la promesse et event.reason contient la raison du rejet. Enregistrer ce gestionnaire d’événement ne traite pas le rejet en soi ; la promesse doit être traitée, par exemple avec .catch().
L’exemple attend unhandledrejection, puis ajoute .catch() lors d’une tâche ultérieure. preventDefault() supprime le signalement par défaut du premier événement, mais ne traite pas la promesse. La page devrait afficher handled: demo.
Exemples
<!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>Résultat
handled: demo
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.