HarmonyOS API：已停止维护的接口

版本：v3.1 Beta

@ohos.bytrace (性能打点)

更新时间: 2023-02-17 09:19

本模块提供了追踪进程轨迹。

说明

• 从API Version 8开始，该接口不再维护，推荐使用新接口​​@ohos.hiTraceMeter​​。
• 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import bytrace from '@ohos.bytrace';

bytrace.startTrace

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

标记一个时间片跟踪任务的开始。

说明

如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次，并且这些跟踪任务会同时被执行，则每次调用startTrace的taskId必须不一致。如果具有相同name的跟踪任务是串行执行的，则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。

系统能力： SystemCapability.HiviewDFX.HiTrace

参数：

示例：

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

bytrace.finishTrace

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

标记一个时间片跟踪事件的结束。

说明

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

系统能力： SystemCapability.HiviewDFX.HiTrace

参数：

示例：

bytrace.finishTrace("myTestFunc", 1);

// 跟踪并行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
// 业务流程...... 
bytrace.startTrace("myTestFunc", 2);  // 第二个跟踪任务开始，同时第一个同名跟踪任务还没结束，出现了并行执行，对应接口的taskId需要不同
// 业务流程...... 
bytrace.finishTrace("myTestFunc", 1);
// 业务流程...... 
bytrace.finishTrace("myTestFunc", 2);

// 跟踪串行执行的同名任务
bytrace.startTrace("myTestFunc", 1);
// 业务流程...... 
bytrace.finishTrace("myTestFunc", 1);  // 第一个跟踪任务结束
// 业务流程...... 
bytrace.startTrace("myTestFunc", 1);   // 第二个跟踪任务开始，同名跟踪任务串行执行
// 业务流程...... 
bytrace.finishTrace("myTestFunc", 1);

bytrace.traceByValue

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

标记预追踪耗时任务的数值变量，该变量的数值会不断变化。

系统能力： SystemCapability.HiviewDFX.HiTrace

参数：

示例：

let traceCount = 3;
bytrace.traceByValue("myTestCount", traceCount);
traceCount = 4;
bytrace.traceByValue("myTestCount", traceCount);
// 业务流程......

@ohos.document (文件交互)

更新时间: 2023-02-17 09:19

说明

• 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
• 本模块接口从API version 9开始废弃。不建议使用以下接口，调用以下接口将抛出异常。

导入模块

import document from '@ohos.document';

document.choose^(deprecated)

choose(types?: string[]): Promise<string>

通过文件管理器选择文件，异步返回文件URI，使用promise形式返回结果。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

返回值：

示例：

let types = [];
document.choose(types);

document.choose^(deprecated)

choose(callback:AsyncCallback<string>): void

通过文件管理器选择文件，异步返回文件URI，使用callback形式返回结果。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

示例：

let uri = "";
document.choose(function(err, uri) {
      //do something with uri
});

document.choose^(deprecated)

choose(types:string[], callback:AsyncCallback<string>): void

通过文件管理器选择文件，异步返回文件URI，使用callback形式返回结果。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

示例：

let types = [];
let uri = "";
document.choose(types, function(err, uri) {
      //do something with uri
});

document.show^(deprecated)

show(uri:string, type:string):Promise<void>

异步打开URI对应的文件，使用promise形式返回结果。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

返回值：

示例：

let type = "";
let uri = "";
document.show(uri, type);

document.show^(deprecated)

show(uri:string, type:string, callback:AsyncCallback<void>): void

异步打开URI对应的文件，使用callback形式返回结果。

系统能力：SystemCapability.FileManagement.UserFileService

参数：

示例：

let type = "";
let uri = "";
document.show(uri, type, function(err) {
      //do something
});

import featureAbility from '@ohos.ability.featureAbility';let context = featureAbility.getContext();context.getFilesDir().then(function (path) {function(err, number) {        console.info("getTotalBytes callback successfully:" + number);    });});

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-document-0000001478061989-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001478061989__导入模块​​