seer-jsniffer.js

(function(global, Sai){

  if(!Sai){return;}

  var DEFAULT_PROFILE = "jserror";
  var MAX_STACKTRACE_DEEP = 20;
  var RE_FUNCTION = /^\s*function\b[^\)]+\)/;

  var lost_resources = [];
  var lost_resources_cache = {};

  // 客户端资源加载失败时调用这个接口。
  Sai.lost = function(uri){
    if(lost_resources_cache.hasOwnProperty(uri)){return;}
    lost_resources_cache[uri] = true;

    lost_resources.push(uri);
    return lost_resources;
  };

  // 获得函数名。
  // @param {Function} func, 函数对象。
  // @return {String} 函数名。
  function function_name(func){
    var match = String(func).match(RE_FUNCTION);
    return match ? match[0] : "global";
  }

  // 函数调用堆栈。
  // @param {Function} call, function's caller.
  // @return {String} stack trace.
  function stacktrace(call){
    var stack = [];
    var deep = 0;

    while(call.arguments && call.arguments.callee && call.arguments.callee.caller){

      call = call.arguments.callee.caller;
      stack.push("at " + function_name(call));

      // Because of a bug in Navigator 4.0, we need this line to break.
      // c.caller will equal a rather than null when we reach the end
      // of the stack. The following line works around this.
      if (call.caller === call){break;}

      if((deep++) > MAX_STACKTRACE_DEEP){break;}
    }
    return stack.join("\n");
  }

  // 用于缓存识别同一个异常。
  var ERROR_CACHE = {};

  // JavaScript 异常统一处理函数。
  // @param {String} catchType, 捕获异常的类型。
  // @param {String} message, 异常消息。
  // @param {String} file, 异常所在文件。
  // @param {Number} line, 异常所在行。
  // @param {Number,String} number, 异常编码，IE 支持。
  // @return {Object} 主要用于单元测试，本身可以不返回。
  function error(catchType, message, file, line, column, number, stack){
    if(!stack && arguments.callee.caller){
      stack = stacktrace(arguments.callee.caller);
    }

    var data = {
      profile: DEFAULT_PROFILE,
      type: catchType,
      msg: message || "",
      file: file || "",
      line: line || 0,
      col: column || 0,
      num: number || "",
      stack: stack || "",
      lang: navigator.language || navigator.browserLanguage || "",
      lost: lost_resources.join(",")
    };

    var key = file + ":" + line + ":" + message;
    if(!ERROR_CACHE.hasOwnProperty(key)){
      data.uv = 1;
      ERROR_CACHE[key] = true;
    }

    return Sai.log(data);
  }


  // JavaScript 异常接口，用于监控 `try/catch` 中被捕获的异常。
  // @param {Error} err, JavaScript 异常对象。
  // @return {Object} 主要用于单元测试。
  Sai.error = function(ex){
    if(!(ex instanceof Error)){return;}

    return error(
      "catched",
      ex.message || ex.description,
      ex.filename || ex.fileName || ex.sourceURL,
      ex.lineno || ex.lineNumber || ex.line,
      ex.colno || ex.columnNumber,
      ex.number,
      ex.stack || ex.stacktrace
    );
  };

  // 全局 JavaScript 异常监控。
  // @return {Boolean} 返回 `true` 则捕获异常，浏览器控制台不显示异常信息。
  //                   返回 `false` 则不捕获异常，浏览器控制台显示异常信息。
  //                   建议返回 `false`。
  global.onerror = function(message, file, line, column) {
    error("global", message, file, line, column);
    return false;
  };

})(this, this.Sai);