性能打点

说明： 从 API Version 7 开始支持。

导入模块

import bytrace from '@ohos.bytrace';

权限

无

bytrace.startTrace

startTrace(name: string, taskId: number, expectedTime?: number): void

标记一个预追踪耗时任务的开始，expectedTime是可选参数，标识该任务的期望耗时。

• 参数：

  参数名	类型	必填	说明
  name	string	是	要追踪的任务名称
  taskId	number	是	任务id
  expectedTime	number	否	期望的耗时时间，单位：ms

  说明： 如果多个要追踪任务的name相同，taskId必须不一致。通过name和taskId来唯一标识一个任务。

• 示例：

  bytrace.startTrace("myTestFunc", 1);
  bytrace.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
  

bytrace.finishTrace

finishTrace(name: string, taskId: number): void

标记一个预追踪耗时任务的结束。

• 参数：

  参数名	类型	必填	说明
  name	string	是	要追踪的任务名称
  taskId	number	是	任务id

  说明： finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。

• 示例：

  bytrace.finishTrace("myTestFunc", 1);
  

bytrace.traceByValue

traceByValue(name: string, count: number): void

用来标记一个预追踪的数值变量，该变量的数值会不断变化。

• 参数：

  参数名	类型	必填	说明
  name	string	是	要追踪的数值变量名称
  count	number	是	变量的值

• 示例：

  let traceCount = 3;
  bytrace.traceByValue("myTestCount", traceCount);
  ......
  traceCount = 5;
  bytrace.traceByValue("myTestCount", traceCount);