如何使用JavaScript捕获Web控制台输出的错误与警告信息
原生JS实现控制台错误/警告采集的完整方案
这套实现可以覆盖所有会输出到F12开发者控制台的错误、警告信息,包括业务代码主动输出的日志、未捕获的运行时异常、资源加载错误、未处理的Promise异常。
拦截console方法采集主动输出的日志
要采集console.error、console.warn主动输出的内容,核心是在业务脚本加载前重写原生console方法,保留原有输出能力的同时把内容存下来:
// 提前缓存原生方法,避免覆盖后丢失原有控制台能力 const originConsoleError = console.error; const originConsoleWarn = console.warn; // 统一存储采集到的日志,后续可按需上报到服务端 const collectedLogs = []; // 重写console.error console.error = function(...args) { // 先执行原有输出逻辑,保证控制台正常展示内容 originConsoleError.apply(console, args); // 处理参数,把Error对象拆解成可存储的结构 const logContent = args.map(item => { if (item instanceof Error) { return { message: item.message, stack: item.stack } } return String(item); }) collectedLogs.push({ level: 'error', content: logContent, time: Date.now() }) } // 重写console.warn,逻辑与error一致 console.warn = function(...args) { originConsoleWarn.apply(console, args); const logContent = args.map(item => { if (item instanceof Error) { return { message: item.message, stack: item.stack } } return String(item); }) collectedLogs.push({ level: 'warning', content: logContent, time: Date.now() }) }
注意:这段代码必须放在页面所有其他脚本的最前面执行(比如HTML的head标签最顶部),否则会错过业务脚本加载早期输出的日志。
捕获运行时错误与静态资源加载错误
未被try/catch包裹的JS运行时错误、img/script/link等静态资源加载失败的提示,都会直接输出到控制台,通过监听window的error事件可以采集到:
// 第三个参数传true,开启捕获阶段监听,否则抓不到不冒泡的静态资源加载错误 window.addEventListener('error', (event) => { // 区分静态资源加载错误 if (event.target?.src || event.target?.href) { collectedLogs.push({ level: 'error', type: 'resource_load_error', resourceUrl: event.target.src || event.target.href, tagName: event.target.tagName, time: Date.now() }) return; } // 捕获普通JS运行时错误 collectedLogs.push({ level: 'error', type: 'runtime_js_error', message: event.message, file: event.filename, line: event.lineno, column: event.colno, stack: event.error?.stack, time: Date.now() }) }, true)
注意:跨域加载的JS抛出的错误,浏览器出于安全限制只会返回笼统的
Script error.,拿不到完整信息。需要给对应script标签加crossorigin属性,同时服务端配置允许跨域的CORS响应头,才能采集到完整的错误堆栈。
捕获未处理的Promise异常
Promise中reject后没有被catch捕获的异常,控制台会输出Uncaught (in promise) xxx,通过监听unhandledrejection事件采集:
window.addEventListener('unhandledrejection', (event) => { collectedLogs.push({ level: 'error', type: 'unhandled_promise_rejection', reason: event.reason instanceof Error ? { message: event.reason.message, stack: event.reason.stack } : String(event.reason), time: Date.now() }) })
落地注意事项
- 不要在采集逻辑内部抛出新的错误,避免造成无限循环的错误上报,采集代码本身需要加异常兜底
- 日志存储要设置上限,比如最多保留最近200条记录,避免长时间运行的单页应用占用过多内存
- 不要随意调用事件的
preventDefault()方法,否则会破坏原有控制台的错误输出能力,影响开发调试
内容的提问来源于stack exchange,提问作者Deka Thomas
相关产品推荐
相关产品推荐

