Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Window : évènement rejectionhandled
L'évènementrejectionhandled est envoyé à la portée globale du script (il s'agit généralement dewindow, mais ça peut aussi êtreWorker) lorsqu'unepromesse rompue est gérée tardivement, c'est-à-dire lorsqu'un gestionnaire est attaché à la promesse après que celle-ci a échoué en entraînant un évènementunhandledrejection.
Cet évènement peut être utilisé pour le débogage et pour la résilience des applications en général. On pourra l'utiliser avec l'évènementunhandledrejection qui est émis lorsqu'une promesse est rompue et qu'elle n'a pas de gestionnaire d'échec à ce moment.
Syntaxe
On pourra utiliser le nom de l'évènement dans des méthodes commeaddEventListener(), ou utiliser une propriété qui est un gestionnaire d'évènement.
addEventListener("rejectionhandled", (event) => {});onrejectionhandled = (event) => {};Type d'évènement
Un objet de typePromiseRejectionEvent qui hérite deEvent.
Propriétés de l'évènement
PromiseRejectionEvent.promiseLecture seuleLapromesse JavaScript qui a été rompue.
PromiseRejectionEvent.reasonLecture seuleUne valeur ou un objet qui indique la raison de l'échec de la promesse, comme celui qui serait passé à
Promise.reject().
Alias pour les gestionnaires d'évènement
En plus de l'interfaceWindow, la propriétéonrejectionhandled pour gérer l'évènement est disponible sur les cibles suivantes :
Exemple
L'évènementrejectionhandled peut être utilisé afin de journaliser les promesses rompues dans la console, ainsi que les raisons de leur échec :
window.addEventListener( "rejectionhandled", (event) => { console.log(`Promesse rompue - raison : ${event.reason}`); }, false,);Spécifications
| Specification |
|---|
| HTML # unhandled-promise-rejections |
| HTML # handler-window-onrejectionhandled |