try-catch仅捕获同步运行时错误,无法捕获语法错误、异步错误(如setTimeout、Promise、事件回调)、top-level await拒绝;必须配合await才能捕获Promise reject,否则需用.catch()或监听unhandledrejection。

try-catch 只捕获同步运行时错误
它不能捕获语法错误、异步错误(如 setTimeout 或 Promise 中抛出的错误)、事件回调里的未捕获异常,也不能捕获 top-level await 在模块作用域中引发的拒绝(除非在 async 函数内)。真正被 try-catch 捕获的,仅限于当前执行栈中同步执行路径上抛出的 Error 实例或任意值(比如 throw "oops")。
常见误判场景:
- 写了
try { fetch(...) } catch(e) { ... },但fetch本身不抛错,返回的是Promise,错误实际发生在.catch()或await后 —— 此时try-catch完全无效 -
addEventListener("click", () => { throw new Error("boom") }):这个throw不在try块内,会直接变成未捕获异常 -
JSON.parse("{ invalid }")这类会触发,因为它是同步且立即执行的
async/await 中 try-catch 必须配合 await 使用
只要 await 等待的 Promise 被 reject,try-catch 就能捕获它 —— 但前提是必须 await,不能只写 promise.then().catch() 混用。
async function handleData() {
try {
const res = await fetch("/api/data");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const json = await res.json(); // ← 这里可能 SyntaxError
return json;
} catch (err) {
// err 可能是网络错误、HTTP 错误、JSON 解析错误
console.error("Caught:", err.message);
}
}
注意:await 是关键。如果写成 fetch(...).then(...),即使整个链路包在 try 里,也不会被捕获 —— 因为 .then 创建了新的微任务执行上下文。
立即学习“Java免费学习笔记(深入)”;
Promise 链中的错误必须用 .catch() 或顶层 await + try-catch
Promise 的错误传播是链式的,不会自动冒泡进外层 try-catch,除非你显式 await 它或调用 .catch()。
以下写法无法捕获错误:
try {
Promise.reject(new Error("nope")).catch(console.error);
} catch (e) {
// 永远进不来
}
正确做法二选一:
- 用
await:try { await Promise.reject(...) } catch (e) { ... } - 用链式
.catch():Promise.reject(...).catch(e => console.error(e))
漏掉 .catch() 且没 await 的 Promise rejection,在现代浏览器和 Node.js 中会触发 unhandledrejection 事件,属于“未处理拒绝”,应监听并记录:
window.addEventListener("unhandledrejection", (event) => {
console.error("Unhandled rejection:", event.reason);
event.preventDefault(); // 阻止控制台警告(仅开发时慎用)
});
全局错误与跨域脚本的限制
window.onerror 和 window.addEventListener("error") 能捕获全局同步/异步错误(包括资源加载失败),但对跨域脚本(如 CDN 上的 JS)抛出的错误,浏览器出于安全限制,只会给出模糊信息:Script error.,没有堆栈、无文件名行号。
要获取真实错误信息,需满足两个条件:
- 脚本标签加
crossorigin="anonymous"属性 - 服务端响应头包含
Access-Control-Allow-Origin: *(或明确域名)
否则,哪怕你在自己的域名下引入了跨域 JS,里面的 throw new Error("xxx") 也会被降级为 Script error. —— 这个细节在线上错误监控中极易被忽略。











