Окно: метод reportError()

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

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

throwable

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

None (undefined).

TypeError

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

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

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

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

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

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

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

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

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