自定义异常上报

本文介绍如何使用SDK上报自定义异常。

功能描述

自定义异常指业务应用自己定义的错误,在应用运行过程中由业务代码主动捕获,可以根据业务需要上报到崩溃分析服务,进行数据采集。

使用场景

适用于业务主动捕获的错误,并需要采集分析的场景,比如:

  1. 业务核心功能,并进行了错误捕获,需要主动上报采集

  2. 用户无感的异步业务流程,需要捕获错误,主动上报

  3. 系统API低概率的错误处理,可以主动上报以发现线上可能的问题

接口定义

定义如下:

export interface CrashAnalysisApi extends IPlugin {
  reportCustomError(error: string | Error): void;
}

error参数即需要上报的自定义异常,可以是字符串类型,也可以是Error类型。

代码示例

crashAnalysisApi.reportCustomError("字符串作为自定义错误");
crashAnalysisApi.reportCustomError(new Error('自定义一个错误'));
try {
  await http.createHttp().request("");
} catch (e) {
  crashAnalysisApi.reportCustomError(e as Error);
}