大网数据广告活动
Web 标准与前端开发

Window:reportError() 方法

· 52CE 我爱测

Window 接口的 **`reportError()`** 方法可模拟未捕获的 JavaScript 异常,向控制台或全局事件处理器报告错误。

DOM

Window 接口的 reportError() 方法可模拟未捕获的 JavaScript 异常,向控制台或全局事件处理器报告错误。

此特性主要用于自定义事件分发或回调处理库。库可以借此特性以捕获回调代码中的的错误,并将其重新抛出至顶层处理器。这确保了一个回调中出现的异常不会阻碍其他回调的处理,同时也确保了在顶层调试时仍可方便地获取堆栈跟踪信息。

语法

reportError(throwable)

参数

  • throwable
    • : error 对象,例如 TypeError。

返回值

无(undefined)。

异常

  • TypeError
    • : 调用方法时没有传入 error 实参。

示例

检查特性是否可用:

if (typeof window.reportError === "function") {
  // 函数已定义
}

以下代码展示了如何创建和报告错误,以及如何使用 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(`消息:${error.message},行号:${lineno}`);
  return true;
};

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

// 输出
// > "消息:Some error message,行号:11"
// > "someFile.js"

规范

浏览器兼容性

参见

  • Window
  • WorkerGlobalScope.reportError()
  • Window:Window/error_event 事件
  • WorkerGlobalScope:WorkerGlobalScope/error_event 事件
  • HTMLElement:HTMLElement/error_event 事件

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。