Spec-Zone.ru › Web APIs

Окно: событие rejectionhandled

Событие rejectionhandled отправляется в глобальную область видимости скрипта (обычно window, но также и Worker) всякий раз, когда обработка отклоненного JavaScript Promise выполняется поздно, т.е. когда обработчик прикреплён к обещанию после того, как его отклонение вызвало событие unhandledrejection.

Это можно использовать для отладки и обеспечения общей устойчивости приложения, в сочетании с событием unhandledrejection, которое отправляется, когда обещание отклонено, но в момент отклонения нет обработчика.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика события.

addEventListener("rejectionhandled", (event) => {});
onrejectionhandled = (event) => {};

Тип события

Объект PromiseRejectionEvent. Наследуется от Event.

Событие PromiseRejectionEvent

Свойства события

PromiseRejectionEvent.promise Только для чтения

JavaScript Promise, который был отклонен.

PromiseRejectionEvent.reason Только для чтения

Значение или Object, указывающее причину отклонения обещания, переданное в Promise.reject().

Псевдонимы обработчика событий

В дополнение к интерфейсу Window, свойство обработчика событий onrejectionhandled также доступно для следующих целевых элементов:

  • HTMLBodyElement
  • HTMLFrameSetElement
  • SVGSVGElement

Пример

Вы можете использовать событие rejectionhandled для регистрации в консоли обещаний, которые отклонены, а также причин их отклонения:

window.addEventListener(
  "rejectionhandled",
  (event) => {
    console.log(`Promise rejected; reason: ${event.reason}`);
  },
  false,
);

Спецификации

Спецификация
HTML
# unhandled-promise-rejections
HTML
# handler-window-onrejectionhandled

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
rejectionhandled_event 49 79 69 36 11 49 79 36 11.3 5.0 49

См. также

  • События отклонения обещаний
  • PromiseRejectionEvent
  • Promise
  • unhandledrejection

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Window/rejectionhandled_event

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API