跳转到主要内容

调试

错误类型

该软件包的主要目标是报告性能指标。但是,有时该库会遇到错误 - 内部错误或由不正确的使用引起。默认情况下,该库仅报告可操作影响测量的错误。

性能库产生两种错误类型

  • bug 错误与内部问题相关,并由库本身处理,
  • 当我们检测到不正确的库使用时,会抛出fatal 错误,并将其传递给PerformanceProfiler中的errorHandler

只有fatal 错误才会进入错误处理程序,并抛给应用程序,并且(可能)抛给错误仪表板。这些错误是合法的,并且应该是可操作的。您可以在此处了解有关fatal错误的更多信息。

内部的 bug 错误表示某些地方出现错误,或者存在库尚不支持的未处理流程。当您处于 DEBUG 模式时,它们将显示出来。当您遇到 bug 错误时,我们恳请您报告问题,以便我们进行调查。

日志记录器

我们重视开发人员的控制台,并且不希望用开发人员可能暂时不需要的信息来淹没它。但是,如果需要调试性能问题,则可以记录详细信息。

日志记录分为多个级别:错误、警告、信息和调试。您可以明确地告诉库当前需要哪个最低级别。例如,您可能希望在检查性能问题时使用info级别的日志,而在处理其他问题时禁用它们。

以下三个日志级别可用

  • Error 级别将记录内部错误和表示库 API 使用不正确的错误
  • Warn 级别记录的不是错误,而是警告,表示某些事情没有按预期进行
  • Info 级别记录对调试性能问题有用的其他信息 + 渲染通道报告。
  • Debug 是最低级别,包括用于调试软件包本身的任何其他信息 + 状态机更改。

默认情况下,PerformanceProfiler 使用日志级别 warn 进行初始化。这意味着在调试版本中,错误和警告将显示在控制台上。由于 console。*调用是同步的,因此日志记录仅在开发环境中(当 React Native 打包器正在运行时)进行,以确保它不会降低已发布应用程序的性能。

要更改日志级别,请更改传递给 PerformanceProfiler 的 prop

tsx
<PerformanceProfiler logLevel={LogLevel.Debug}>
tsx
<PerformanceProfiler logLevel={LogLevel.Debug}>