# tracker-js

**Repository Path**: peigenzi/tracker-js

## Basic Information

- **Project Name**: tracker-js
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-07
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tracker-js

tracker-js 是一款前端错误上报工具。可以捕获并上报 js 运行时发生的错误。支持抽样上报和限制重复上报。

**支持捕获的异常**

- js 错误信息
- promise 未捕获的异常信息
- xhr 异常信息
- 资源错误信息
- vue 错误信息

**支持捕获的设备信息**

- 设备类型
- 操作系统

## 使用

tracker-js 必须在所以类库之前加载并初始化。

**初始化**

```js
let trackerJs = new TrackerJs({
  id: 1,
  url: '/err.com/trackerjs',
});

//捕获 vue 里的错误需要先初始化，再调用 initVue 方法
import Vue from 'vue';
trackerJs.initVue({ vue: Vue });
```

**配置**

```js
new TrackerJs({
  id: 1, //上报 id, 不指定将不上报
  url: '/err.com/trackerjs', //上报地址，不指定将不上报
  repeat: 5, // 同一个错误超过多少次不上报
  random: 0.5, // 抽样上报，1~0 之间数值
});
```

**手动上报**

```js
let trackerJs = new TrackerJs({
  id: 1,
  url: '/err.com/trackerjs',
});

trackerJs.submitLog({ msg: 'err' }); // 必须要对象，而且有 msg 属性
```