PromiseRejectionEvent()
Конструктор PromiseRejectionEvent()
створює та вертає PromiseRejectionEvent
, що відображає події, запущені, коли об'єкт JavaScript Promise
був відхилений. З подіями відхилення промісів стає можливим виявляти та повідомляти про проміси, чиє неуспішне завершення пройшло непоміченим. Також стає легше писати глобальні обробники для помилок.
Існують два типи подій PromiseRejectionEvent
: unhandledrejection надсилається середовищем виконання JavaScript, коли проміс був відхилений, але відхилення не було оброблене. Подія rejectionhandled видається, якщо проміс був відхилений, але відхилення було перехоплене обробником відхилень.
Синтаксис
promiseRejectionEvent = PromiseRejectionEvent(type, options);
Параметри
Конструктор PromiseRejectionEvent()
також успадковує параметри від Event()
.
type
- Рядок, що відображає ім'я типу події
PromiseRejectionEvent
. Він чутливий до регістру, і повинен мати значення "rejectionhandled" або "unhandledrejection", щоб відповідати іменам можливих (не штучно створених) подійPromiseRejectionEvent
, які можуть запустити програмні агенти). options
Об'єкт
, що визначає деталі відхилення:
Значення, що повертається
Нова подія PromiseRejectionEvent
, що має конфігурацію, визначену параметрами.
Приклади
Цей приклад створює нову подію unhandledrejection для проміса myPromise
з причиною-рядком "Мій будинок горить". Параметр reason
(причина) міг так само легко бути числом, чи навіть об'єктом з детальною інформацією, що містить адрес будинку, чи опис того, наскільки сильний вогонь, і номер телефону людини, яку потрібно повідомити.
let myRejectionEvent = new PromiseRejectionEvent("unhandledrejection", {
promise : myPromise,
reason : "Мій будинок горить"
});
Специфікації
Специфікація | Статус | Коментар |
---|---|---|
HTML Living Standard The definition of 'the PromiseRejectionEvent interface' in that specification. |
Living Standard | Початкове визначення. |
Сумісність з веб-переглядачами
BCD tables only load in the browser