You need to enable JavaScript to run this app. 如何使用JavaScript捕获Web控制台输出的错误与警告信息
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 10:54:04