badjs-report -- 前端日志上报与JS异常监控
Author
Install
$ npm install badjs-report
$ bower install https://github.com/BetterJS/badjs-report.git
$ lego install badjs-report --save
Getting Started
badjs-report 必须在所有类库之前加载并初始化。 但是要在 jquery、seajs、requrejs等类库后调用spyAll()。
初始化
BJ_REPORT;
配置说明
BJ_REPORT;
BJ_Report 是重写了 window.onerror 进行上报的,无需编写任何捕获错误的代码
手动上报
BJ_REPORT; BJ_REPORT; try // something throw error ...catcherror BJ_REPORT;
延迟上报
BJ_REPORT; BJ_REPORT; BJ_REPORT;
上报离线日志
BJ_REPORT;
什么是离线日志? #25
用法
//初始化BJ_REPORT //主动上报错误日志BJ_REPORT; //info上报,用于记录操作日志BJ_REPORT; //可以结合实时上报,跟踪问题; 不存入存储BJ_REPORT; //记录离线日志 BJ_REPORT;
高级用法
script error 的错误,怎么解决? #3
由于 BJ_Report 只是重写了onerror 方法而已,而且浏览器的跨域问题不能获得外链 javascript 的错误,所以使用tryJs 进行包裹。
包裹jquery
BJ_REPORT;
包裹 jquery 的 event.add , event.remove , event.ajax 这几个异步方法。
包裹 define , require
BJ_REPORT;
包裹 模块化框架 的 define , require 方法
包裹 js 默认的方法
BJ_REPORT;
包裹 js 的 setTimeout , setInterval 方法
包裹 自定义的方法
var {};customFunction = BJ_REPORT; // 只会包裹 customOne , customTwovar customObject = {} {} customVar : 1BJ_REPORT;
包裹 自定义的方法或则对象
运行所有默认的包裹
//自动运行 SpyJquery , SpyModule , SpySystemBJ_REPORT;
update log
v1.3.3
- BUGFIX
v1.3.1
- 支持离线日志
- 支持自动上报离线日志
v1.2.3
- BUGFIX
v1.2.1
- 增加去除重复参数
- 修复了 webpack 引入问题
- BUGFIX
v1.1.8
- 项目重命名后更新项目路径(注: 之前名字为
report
)
v1.1.7
- 合并上报的问题
- 增加sea.use try-catch 处理
v1.1.6
- add BJ_ERROR hash
v1.1.5
- bugfix
v1.1.4
- 增加info 和 debug 接口
- report 增加对 error 对象处理
- 处理 [Object event] 问题
v1.1.3
- bugfix
v1.1.2
- 增加抽样参数 random
v1.1.1
- seajs 兼容的BUG修复
- 增加 ext 属性,用户可以自己定义里面的值上报
v1.1.0
- 增加对seajs 模块化的包裹
- 增加对IE下面的错误的上报
v1.0.5
- 修复异步环境下抛给浏览器的BUG也会上报,
- 修复ignore 数组判断的迭代的问题
v1.0.4
- 修复 spy 插件增加在 异步环境中,抛出异常捕获后,再抛给浏览器
- 修复 增加在异步环境中,抛出异常,捕获后,将错误信息输出
- 增加onReport 回调
v1.0.3
- 修复说明文档
v1.0.2
- 修复 uin 的正则
v1.0.1
- 增加 spy 插件
v1.0.0
- 功能上线