window.onerror仅捕获同步运行时错误，无法捕获Promise拒绝、async/await异常、资源加载失败等异步错误；需配合onunhandledrejection、error事件等实现全局错误监控。
window.onerror 是浏览器提供的全局错误监听机制，用于捕获 JavaScript 执行过程中发生的**同步运行时错误**（如语法正确但运行时报错：引用未定义变量、调用非函数值等）。但它**无法直接捕获异步错误**（如 Promise 拒绝、setTimeout 中抛出的错误、fetch 失败未 catch 等），这是它的核心限制。
它能捕获哪些错误？
仅限以下同步执行上下文中的 throw 错误：
- 全局作用域中直接执行的代码（如
throw new Error('boom')） - 事件处理器内同步抛出的错误（如
btn.onclick = () => { undefined.foo(); }） - 普通函数调用链中未被 try/catch 拦截的错误
注意：它不捕获 Promise rejection、async/await 中未处理的异常、XMLHttpRequest 网络错误、资源加载失败（如 script 404）等。这些需要其他机制配合。
基本用法与参数含义
注册方式：
立即学习“Java免费学习笔记（深入）”；
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
window.onerror = function(message, source, lineno, colno, error) {
console.log('错误信息:', message);
console.log('脚本来源:', source);
console.log('行号:', lineno);
console.log('列号:', colno);
console.log('Error 对象:', error); // 可能为 null（老浏览器或某些场景）
return true; // 阻止默认错误提示（可选）
};
关键点：
- message：错误描述字符串（如 "Uncaught ReferenceError: xxx is not defined"）
- source：出错脚本的 URL（可能为空，如内联 script）
- lineno / colno：错误发生的具体位置（行、列）
- error：原生 Error 实例（现代浏览器支持，含 stack、name、message 等，最可靠）
- 返回 true 可阻止控制台打印该错误（慎用，调试时建议留空或返回 false）
如何捕获异步错误？必须搭配其他 API
要实现“全局捕获同步 + 异步错误”，需组合使用：
- PromiseRejectionEvent（window.onunhandledrejection）：捕获未被 catch 的 Promise rejection
- error 事件监听（document.addEventListener('error')）：捕获资源加载失败（img、script、link 等）
- console.error 拦截（慎用）：非标准但有时用于兜底（不推荐作为主方案）
示例整合：
// 同步错误
window.onerror = (msg, url, line, col, err) => {
reportError({ type: 'js-error', msg, url, line, col, stack: err?.stack });
};
// Promise 异步拒绝
window.onunhandledrejection = (event) => {
const reason = event.reason;
reportError({
type: 'promise-reject',
msg: reason?.message || String(reason),
stack: reason?.stack,
context: 'unhandled promise rejection'
});
};
// 资源加载失败
document.addEventListener('error', (e) => {
if (e.target && e.target.src) {
reportError({
type: 'resource-error',
target: e.target.tagName,
src: e.target.src,
timestamp: Date.now()
});
}
}, true);
注意事项与常见陷阱
实际使用中容易忽略的关键细节：
-
CSP（内容安全策略）影响：若启用了 strict CSP，跨域脚本错误会脱敏（message 变成 "Script error."，无行列信息），需配置
script-src 'self' 'unsafe-inline'或添加crossorigin属性并确保服务端返回 CORS 头 - try/catch 会拦截错误：一旦被局部 try/catch 捕获，就不会触发 window.onerror
-
不能捕获语法错误（SyntaxError）：脚本加载阶段的语法错误发生在执行前，onerror 不生效；可通过
<script onerror>或 service worker 拦截 script 请求做预检 - 第三方脚本干扰：有些 SDK（如某些监控工具）会重写 window.onerror，注意执行顺序和兼容性
不复杂但容易忽略。
