CKTIS / HTML
onunhandledrejection — rejet de promesse non traité
L’attribut onunhandledrejection sur body enregistre un gestionnaire pour l’événement unhandledrejection de l’objet Window. Il donne accès à la raison du rejet d’une promesse qui n’a toujours pas de gestionnaire de rejet au moment de la notification.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onunhandledrejection="/* JavaScript using event */">onunhandledrejection est un attribut de gestionnaire d’événement dont la valeur est du code JavaScript. Sur body, il définit le gestionnaire de l’événement unhandledrejection de l’objet Window, et non celui d’un événement distinct de l’élément. Ce n’est pas un attribut HTML global ordinaire disponible sur chaque élément. Son équivalent JavaScript est la propriété window.onunhandledrejection.
La notification est asynchrone. Si un gestionnaire de rejet est ajouté suffisamment tôt, l’événement ne se produit pas. L’objet event est un PromiseRejectionEvent : event.promise désigne la promesse rejetée et event.reason contient la raison du rejet.
L’appel de event.preventDefault() annule le signalement par défaut de cet événement dans la console ; il ne répare pas la promesse. Traitez les échecs prévisibles à leur source plutôt que de compter uniquement sur une notification globale.
L’exemple définit l’attribut sur body et traite le rejet de la promesse avec promise.catch(() => {}). L’appel à window.dispatchEvent() déclenche sur window un événement unhandledrejection synthétique et annulable, ce qui invoque le gestionnaire qui affiche event.reason dans la console. L’exemple montre que le gestionnaire est bien raccordé, et non comment le navigateur signale un rejet non traité. Ici, l’appel à event.preventDefault() ne concerne que l’événement synthétique et ne montre pas comment empêcher le signalement par défaut d’un rejet non traité par le navigateur. Le code inline nécessite une autorisation dans la politique de sécurité de la page.
Exemples
<!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>Résultat
reason: 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.