Skip to content

前端错误日志介绍,以及如何监控上报。

Notifications You must be signed in to change notification settings

Yatoo2018/log-report

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

前端异常监控

如果debug是移除bug的流程,那么编程就一定是将bug放进去的流程。 如果没有用户反馈问题,那就代表我们的产品棒棒哒,对不对?

主要内容

  • Web规范中相关前端异常
  • 异常按照捕获方式分类
  • 异常的捕获方式
  • 日志上报的方式

前端异常类型(Execption)

WebIDLecma-262中的错误类型

  • ECMAScript exceptions <==> IDL 的简单异常

    当脚本代码运行时发生的错误,会创建Error对象,并将其抛出,除了通用的Error构造函数外,以下是另外几个ECMAScript 2015中定义的错误构造函数。

    • EvalError eval错误
    • RangeError 范围错误
    • ReferenceError 引用错误
    • TypeError 类型错误
    • URIError URI错误
    • SyntaxError 语法错误 (这个错误��WebIDL中故意省略,保留给ES解析器使用)
    • Error 通用错误 (这个错误��WebIDL中故意省略,保留给开发者使用使用)
  • DOMException 最新的DOM规范定义�的错误类型集,兼容旧浏览的DOMError接口, 完善和规范化DOM错误类型。

    • IndexSizeError 索引不在允许的范围内
    • HierarchyRequestError 节点树层次结构是不正确的。
    • WrongDocumentError 对象是错误的
    • InvalidCharacterError 字符串包含无效字符。
    • NoModificationAllowedError 对象不能被修改。
    • NotFoundError 对象不能在这里被找到。
    • NotSupportedError 不支持的操作
    • InvalidStateError 对象是一个无效的状态。
    • SyntaxError 字符串不匹配预期的模式
    • InvalidModificationError 对象不能以这种方式被修改
    • NamespaceError 操作在XML命名空间内是不被允许的
    • InvalidAccessError 对象不支持这种操作或参数。
    • TypeMismatchError 对象的类型不匹配预期的类型。
    • SecurityError 此操作是不安全的。
    • NetworkError 发生网络错误
    • AbortError 操作被中止
    • URLMismatchError 给定的URL不匹配另一个URL。
    • QuotaExceededError 已经超过给定配额。
    • TimeoutError 操作超时。
    • InvalidNodeTypeError 这个操作的 节点或节点祖先 是不正确的
    • DataCloneError 对象不能克隆。

前端错误异常按照捕获方式分类

  • 运行时异常
    • 语法错误
  • 资源加载异常
    • img
    • script
    • link
    • audio
    • video
    • iframe
    • ...外链资源的DOM元素
  • 异步请求异常
    • XMLHttpRequest
    • fetch
  • Promise异常
  • CSS中资源异常
    • @font-face
    • background-image
    • ...暂时无法捕获

前端错误异常的捕获方式

  • try-catch (ES提供基本的错误捕获语法)
    • 只能捕获同步代码的异常
    • 回调
    • setTimeout
    • promise
  • window.onerror = cb (DOM0)
    • img
    • script
    • link
  • window.addEventListener('error', cb, true) (DOM2)
  • window.addEventListener("unhandledrejection", cb) (DOM4)
  • Promise.then().catch(cb)
  • 封装XMLHttpRequest&fetch | 覆写请求接口对象

try-catch-finally

将能引发异常的代码块放到try中,并对应一个响应,然后有异常会被捕获

  try {
    // 模拟一段可能有错误的代码
    throw new Error("会有错误的代码块")
  } catch(e){
    // 捕获到try中代码块的错误得到一个错误对象e,进行处理分析
    report(e)
  } finally {
    console.log("finally")
  }

onerror事件

window.onerror

当JavaScript运行时错误(包括语法错误)发生时,window会触发一个ErrorEvent接口的事件,并执行window.onerror()

/**
 * @description 运行时错误处理器
 * @param {string} message 错误�信息
 * @param {string} source 发生错误的脚本URL
 * @param {number} lineno 发生错误的行号
 * @param {number} colno 发生错误的列号
 * @param {object} error Error对象
 */
function err(message,source,lineno,colno,error) {...}
window.onerror = err

element.onerror

当一项资源(如<img><script>)加载失败,加载资源的元素会触发一个Event接口的error事件,并执行该元素上的onerror()处理函数。

element.onerror = function(event) { ... } //注意和window.onerror的参数不同

注意:这些error事件不会向上冒泡到window,不过能被单一的window.addEventListener捕获。

window.addEventListener

addEventListener相关的一些内容

W3C DOM2 Events规范中提供的注册事件监听器的方法, 在这之前均使用 el.onclick的形式(DOM0 规范的基本内容,几乎所有浏览器都支持)。

注意: 接口的几种语法

�error事件捕获资源加载错误

资源加载失败,不会�冒泡,但是会被addEventListener捕获,所以我们可以指定在加载失败事件的捕获阶段捕获该错误。

注意�: 接口同时也能捕获运行时错误。

window.addEventListener("error", function(e) {
    var eventType = [].toString.call(e, e);
    if (eventType === "[object Event]") { // 过滤掉运行时�错误
      // 上报加载错误
      report(e)
    }
  },
  true
);

unhandledrejection事件捕获Promise异常

最新的规范中定义了 unhandledrejection事件用于全局捕获promise对象没有�rejection处理器时异常情况。

window.addEventListener("unhandledrejection", function (event) {
    // ...your code here to handle the unhandled rejection...

    // Prevent the default handling (error in console)
    event.preventDefault();
});

Promise.then().catch(cb).finally()

Promise中的错误会被Promise.prototype.catch捕获,所以我们通过这种方式捕获错误,这包括一些不支持unhandledrejection事件的环境�中promisede polyfill实现。

new Promise(function(resolve, reject) {
  throw 'Uncaught Exception!';
}).catch(function(e) {
  console.log(e); // Uncaught Exception!
});

封装XMLHttpRequest&fetch | 覆写请求接口对象

// 覆写XMLHttpRequest API
if(!window.XMLHttpRequest) return;
  var xmlhttp = window.XMLHttpRequest;
  var _oldSend = xmlhttp.prototype.send;
  var _handleEvent = function (event) {
      if (event && event.currentTarget && event.currentTarget.status !== 200) {
        report(event)
      }
  }
  xmlhttp.prototype.send = function () {
      if (this['addEventListener']) {
          this['addEventListener']('error', _handleEvent);
          this['addEventListener']('load', _handleEvent);
          this['addEventListener']('abort', _handleEvent);
          this['addEventListener']('close', _handleEvent);
      } else {
          var _oldStateChange = this['onreadystatechange'];
          this['onreadystatechange'] = function (event) {
              if (this.readyState === 4) {
                  _handleEvent(event);
              }
              _oldStateChange && _oldStateChange.apply(this, arguments);
          };
      }
      return _oldSend.apply(this, arguments);
  }

// 覆写fetch API
if (!window.fetch) return;
var _oldFetch = window.fetch;
window.fetch = function() {
  return _oldFetch
    .apply(this, arguments)
    .then(function(res){
      if (!res.ok) {
        // True if status is HTTP 2xx
        report(res)
      }
      return res;
    })
    .catch(function(error){
      report(res)
    });
}

日志上报的方式

  • 异步请求上报, 后端提供接口,或者直接发到日志服务器
  • img请求上报, url参数带上错误信息
    • eg:(new Image()).src = 'http://baidu.com/tesjk?r=tksjk'

注意跨源脚本异常

当加载自不同域的脚本中发生语法错误时,为避免信息泄露,语法错误的细节将不会报告,而代之简单的 "Script error."

由于同源策略影响,浏览器限制跨源脚本的错误访问,这样跨源脚本错误报错信息如下图:

跨源的脚本的异常

在H5的规定中,只要满足下面俩个条件,是允许获取跨源脚本的错误信息的。

  1. 客户端在script标签上增加crossorigin属性;
  2. 服务端设置js资源响应头Access-Control-Origin:*(或者是域名)。

扩展阅读

业界已经有的监控平台

  • Sentry开源
  • 阿里的ARMS�
  • fundebug
  • FrontJS

几个异常监控的问题

  • 如何保证大家提交的代码是符合预期的? 如何了解前端项目的运行是否正常,是否存在错误?

    代码质量体系控制和错误监控以及性能分析

  • 如果用户使用网页,发现白屏,现在联系上了你们,你们会向他询问什么信息呢?先想一下为什么会白屏?

    我们以用户访问页面的过程为顺序,大致排查一下

    1. 用户没打开网络
    2. DNS域名劫持
    3. http劫持
    4. cdn或是其他资源文件访问出错
    5. 服务器错误
    6. 前端代码错误
    7. 前端兼容性问题
    8. 用户操作出错

    通过以上可能发生错误的环节,我们需要向用户手机一下以下的用户信息

    1. 当前的网络状态
    2. 运营商
    3. 地理位置
    4. 访问时间
    5. 客户端的版本(如果是通过客户端访问)
    6. 系统版本
    7. 浏览器信息
    8. 设备分辨率
    9. 页面的来源
    10. 用户的账号信息
    11. 通过performance API收集用户各个页面访问流程所消耗的时间
    12. 收集用户js代码报错的信息
  • 如果我们使用了脚本代码压缩,然而我们又不想将sourcemap文件发布到线上,我们怎么捕获到错误的具体信息?

  • CSS文件中也存在引用资源,@font-face, background-image ...等这些请求错误该如何进行错误捕获?

总结

  • Web规范中相关前端异常

    • DOM处理异常
    • ECMAScript处理异常
  • 异常按照捕获方式分类

    • 运行时异常
    • 资源加载异常
    • 异步请求异常
    • Promise异常
  • 异常的捕获方式

    • try-catch (ES提供基本的错误捕获语法)
      • 只能捕获同步代码的异常
      • 回调
      • setTimeout
      • promise
    • window.onerror = cb (DOM0)
      • img
      • script
      • link
    • window.addEventListener('error', cb, true) (DOM2)
    • window.addEventListener("unhandledrejection", cb) (DOM4)
    • Promise.then().catch(cb)
    • 封装XMLHttpRequest&fetch | 覆写请求接口对象

    注意点:跨源脚本异常的捕获

  • 日志上报的方式

    • 异步请求上报
    • new img上报
  • 扩展阅读

    • 业界已有的异常监控平台
    • 几个跟异常监控有关的问题

about repo

About

前端错误日志介绍,以及如何监控上报。

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published