monitors-own-js

介绍

monitors-js 是一个轻量级前端错误监控插件

优点

1. 能够获取客户端浏览器环境

2. 支持amd

3. 记录用户操作

4. 自定义项目

5. 自定义过滤错误信息

6. 可选择错误等级

7. 自定义上报域名

8. 插件形式加载，可扩展性高，轻松自定义扩展

9. 业务埋点，自定义埋点信息

如何获取

通过以下方式都可以下载：

执行npm i monitors-js

如何使用

浏览器引入:

    直接引入
    <script src="monitors-js/lib/monitor.js"></script>
    插件引入
    <script src="monitors-js/lib/vuePlugin.js"></script>

    统计标签点击率
    <Button action = '{ "type":"adButton","name":"广告位点击" }'>广告位图片</Button>

1.设置了action属性的标签，被点击后会触发onPointClick 回调，并且序列化后传入参数
2.action格式是JSON字符串( 属性名用"type":"" )
3.可以自定义属性名称 通过 monitor.setAttrName(" data-ac ")

    <img data-ac='{ "type":"adButton","name":"广告位点击" }' src="">

4.有些时候，html，body之类的标签被click，我们不需要记录，我们通过  filterTag 过滤 默认过滤了html,body 标签

    //默认
    new Monitor({
        filterTag:function(tag){
            //自定义标签过滤选项
            return ['body', 'html','button'].indexOf(tag) === -1
        }
    })

5.action 属性可以自定义扩展参数，如user 等参数如  action='{"type":"acButton","user":"xxxx"}'

    ...
    .on('onPointClick',(data)=>{
            console.log(data.user)//xxxx
    })

注意 action 属性是纯字符串属性，在vue中使用也是使用字符串，不能使用对象！

模块引入:

    import Monitor from "monitors-js/lib/monitor.js"
    import vuePlugin from "monitors-js/lib/vuePlugin.js"
    var monitor = new Monitor({
        itemID: 'asdjasdtjk21b3k1j2g3',//唯一的项目Id
        url: '',//若autoPush为true 则自动上报异常 ，跨域需要配置
        autoPush: true,// 是否自动上报异常 ，默认为false
        match: ["localhost"],//需要上报的域名 开发环境下可以不选择上报
        exclude: ['WeixinJSBridge', 'x5onSkinSwitch'],//过滤的错误信息 根据details字段
    })
    //需要最先声明
    monitor
        .addPlugin(vuePlugin)//添加vueError监听 根据errorHandler函数
        .install()
        .on('captureBefore', (data) => {
            //上报异常触发的回调 data 是上报的参数
            console.log(data)
        })
        .on('onPointClick',(data)=>{
            // action = '{ "type":"adButton",name:"广告位点击" }'
            console.log(data.value)
            console.log(data)
        })
    //设置
    monitor.setConfig({
        email:"[e-mail]",
        userName:"张三"
    })    
    new Vue({
        el: "#id",
        created: function () {
            console.log('c')
            1 / x
        },
        render: function (h) {
            return h('Button', 'click')
        }
    })

API:

new Monitor(config)

Monitor构造函数	说明	类型	默认值
itemID	唯一项目Id	string	" "
url	若autoPush为true 则自动上报异常 ,跨域需要配置	string	" "
autoPush	若autoPush为true 则自动上报异常 ,跨域需要配置	boolean	true
match	需要上报的域名 ,开发环境下可以不选择上报	Array	[]
exclude	过滤的错误信息 ,根据details字段	Array	[]
filterTag	过滤html标签	function

可自定义扩展参数

实例方法	说明
addPlugin(function)	添加插件
install()	安装插件
on(type:string,callback:function)	监听事件，captureBefore
setConfig()	修改配置
pushException(op:object)	上传异常
setAttrName(attrName:string)	修改默认属性

监听事件

监听事件type	说明	类型
onInstall	安装完成回调
onPointClick	action回调
captureBefore	上传之前回调

扩展插件

    
    比如vue框架的扩展插件

    export default function vuePlugin() {
        const origin = Vue.config.errorHandler||function(){}
        Vue.config.errorHandler = (error, vm, info) => {
            let details = error.toString();
            let route = ''
            if (vm.$route && vm.$route.meta && vm.$route.meta.title) {
                route = vm.$route.meta.title
            } else if (vm.$route) {
                route = vm.$route.path
            }
            let data = {
                route: route,
                details: details + '   ' + info,
                errorDetails: error.stack,
            }
            this.pushException(data)//调用此方法提交异常

            origin(arguments)
        }
    }
    window.vuePlugin = vuePlugin

提交数据格式

    {
        browserName:Chrome
        phoneSystemType:
        phoneSystemVer:
        phoneName:
        reportTime:
        url:
        itemID:
        email:
        user:
        actions:[]
        route:
        details:
        errorDetails:
    }