npm 包 trackjs 使用教程

前言

当我们开发了一个前端应用程序之后，难免会遇到一些 bug 或者 js 报错信息。这时候，我们使用浏览器自带的控制台或者现成的 js 报错信息上报工具可能并不能满足我们的需求。因此，我们需要一款专业的前端 js 报错监控工具，其中，trackjs 做得相对较出色。本文将为大家详细讲解如何使用 npm 包 trackjs 进行前端 js 报错监控。

安装

安装 trackjs，需要在控制台中执行以下命令：

npm i trackjs --save

安装完成后，我们就可以在项目中使用 trackjs 了。

使用方法

trackjs 的使用非常简单，我们只需新增以下代码：

import TrackJS from 'trackjs';

TrackJS.install({
  token: 'YOUR TOKEN HERE',
  application: 'YOUR APPLICATION NAME HERE'
});

其中，token 是我们在 trackjs 官网注册之后所得到的用于显示监控数据的 api token；application 是用来表示你的项目名称的。只需要替换掉这两个字段的值，我们就可以愉快地使用 trackjs 来监控我们的前端应用程序了。

高级用法

除了基本用法之外，trackjs 还提供了一些高级用法。

自定义错误消息

trackjs 允许我们自定义错误消息，以便我们更好地辨别问题所在。我们可以在安装 trackjs 后通过以下代码来实现：

TrackJS.track('An Error Has Occurred', {
  message: 'This is a custom error message',
  location: window.location.href
});

这段代码会在 trackjs 官网的监控页面上填充一个新的错误消息。

捕获特定错误

我们可以利用 trackjs 的回调函数捕获特定的错误。例如，我们希望捕获所有的网络错误，可以使用以下代码：

TrackJS.track('Network Error', {
  onError: function(payload) {
    var error = payload.data;
    if (error.status === 404) {
      return true;
    }
  }
});

这段代码会在捕获错误后，将所有状态码为 404 的网络错误过滤掉。

总结

通过本文的介绍，我们了解了 npm 包 trackjs 的安装方法和基本用法，以及一些高级用法，包括自定义错误消息和捕获特定错误的方法。我们相信这些知识一定对大家有所帮助，希望大家能够顺利地使用 trackjs 监控自己的前端应用程序。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/trackjs