WorkerGlobalScope: метод reportError()

Метод reportError() интерфейса WorkerGlobalScope может использоваться для сообщения об ошибках в консоль или обработчики событий глобальных областей, эмулируя неперехваченное исключение JavaScript.

Эта функция предназначена в первую очередь для пользовательских библиотек, которые отслеживают события или изменяют поведение обратных вызовов. Библиотеки могут использовать эту функцию для перехвата ошибок в коде обратного вызова и повторного их выброса в обработчик верхнего уровня. Это гарантирует, что ошибка в одном обратном вызове не помешает обработке других, одновременно обеспечивая доступность информации о стеке вызовов для отладки на верхнем уровне.

throwable

Объект ошибки, например, TypeError.

None (undefined).

TypeError

Метод вызван без аргумента ошибки.

Тестирование функции с использованием:

if (typeof self.reportError === "function") {
  // function is defined
}

Следующий код демонстрирует, как создать и сообщить об ошибке, а также как её можно перехватить, используя свойство обработчика событий onerror или добавив слушатель для события error. Обратите внимание, что обработчик, назначенный для onerror, должен возвращать true, чтобы остановить распространение события.

const newError = new Error("Some error message", "someFile.js", 11);
self.reportError(newError);

self.onerror = (message, source, lineno, colno, error) => {
  console.error(`message: ${error.message}, lineno: ${lineno}`);
  return true;
};

self.addEventListener("error", (error) => {
  console.error(error.filename);
});

// Output
// > "message:Some error message, lineno: 11"
// > "someFile.js"

• WorkerGlobalScope
• Window.reportError()
• error событие
• error событие
• error событие