try-catch仅捕获同步代码异常;异步错误需用.catch()、await+try-catch或全局unhandledrejection监听。

javaScript 中的 try-catch 不是用来兜底所有错误的万能开关,它只捕获**同步代码中抛出的异常**;异步操作(如 setTimeout、fetch、promise 回调)里抛错,不加额外处理会直接变成未捕获异常。
哪些错误能被 try-catch 捕获
只有在 try 块内**同步执行时显式抛出(throw)或运行时中断(如访问 undefined.method())** 的错误才会进入 catch。比如:
try { jsON.parse('{ "name": }'); // SyntaxError → 被捕获 console.log(a.b.c); // TypeError → 被捕获 } catch (err) { console.log(err.name); // "SyntaxError" 或 "TypeError" }
但以下情况不会被捕获:
setTimeout(() => { throw new Error('boom') }, 0)-
Promise.reject(new Error('fail'))(未用.catch()或await) - 事件回调里的错误,如
button.addEventListener('click', () => { foo(); })中foo未定义
如何正确捕获 Promise 异步错误
Promise 链中的错误必须用 .catch() 或 await + try-catch 处理,不能靠外层同步 try-catch 包裹:
立即学习“Java免费学习笔记(深入)”;
// ❌ 错误写法:外层 try 无法捕获 Promise 内部错误 try { fetch('/api').then(r => r.json()); } catch (e) { // 这里永远不会执行 }
// ✅ 正确写法 1:链式 .catch() fetch('/api').then(r => r.json()).catch(err => console.error(err)); // ✅ 正确写法 2:async/await + try-catch async function loadData() { try { const res = await fetch('/api'); const data = await res.json(); } catch (err) { console.error('请求或解析失败:', err); } }
catch 块里该做什么,不该做什么
catch 不是日志终点,也不是静默吞错的借口。关键动作要明确:
- 检查
err.name和err.message,区分可恢复错误(如NetworkError)和不可恢复错误(如ReferenceError) - 避免只写
console.log(err)—— 丢失堆栈(err.stack)和错误类型 - 不要在
catch里重新throw err却不加任何上下文,这会让调试变困难 - 若需上报错误,优先用
err instanceof TypeError等判断类型,而非字符串匹配err.name === 'TypeError'
全局错误兜底不能只靠 window.onerror
window.onerror 只能捕获脚本加载错误、语法错误和部分运行时错误,对 Promise 拒绝(unhandledrejection)完全无感。生产环境必须同时监听两个事件:
window.addEventListener('error', event => { console.error('JS Error:', Event.error); }); window.addEventListener('unhandledrejection', event => { console.error('Unhandled Promise Rejection:', event.reason); });
注意:event.error 在某些浏览器中可能为 NULL,应优先读取 event.error || event.reason。
真正难处理的从来不是“怎么写 try-catch”,而是搞清错误发生的位置(同步?微任务?宏任务?)、传播路径(是否被中间层吞掉),以及要不要重试、降级、还是立刻上报 —— 这些决策点,代码里不会自动告诉你。