HarmonyOS API：已停止维护的接口

版本：v3.1 Beta

@ohos.hiAppEvent (应用打点)

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

本模块提供了应用事件打点能力，包括对打点数据的落盘，以及对打点功能的管理配置。

说明

• 本模块接口从API version 9开始废弃，建议使用新接口​​@ohos.hiviewdfx.hiAppEvent​​替代。
• 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import hiAppEvent from '@ohos.hiAppEvent';

使用说明

开发者在使用应用事件打点功能前，需要首先了解应用事件相关的参数规格定义。

事件名称

事件名称为string类型，字符串非空且长度在48个字符以内，有效的字符是0-9、a-z、下划线，只能以小写字母开头，不能以下划线结尾。

事件类型

事件类型为​​EventType​​枚举类型。

事件参数

事件参数为object类型，key为事件的参数名称，value为事件的参数值，其规格定义如下：

• 参数名为string类型，字符串非空且长度在16个字符以内，有效的字符是0-9、a-z、下划线，只能以小写字母开头，不能以下划线结尾；
• 参数值支持string、number、boolean、Array类型；
• 参数值为string类型时，其长度需在8*1024个字符以内，超出会做截断处理；
• 参数值为Array类型时，Array中的元素类型只能全为string、number、boolean中的一种，且元素个数需在100以内，超出会做丢弃处理；
• 参数个数需在32以内，超出的参数会做丢弃处理。

事件回调

开发者在调用事件打点方法后，可以在回调函数中对打点返回值进行处理，当前支持callback形式和Promise形式的回调，其返回值规格定义如下：

• 返回值为0，表示事件校验成功，将事件直接落盘到事件文件；
• 返回值大于0，表示事件校验存在异常参数，在忽略异常参数后将事件落盘到事件文件；
• 返回值小于0，表示事件校验失败，不将事件落盘到事件文件。

hiAppEvent.write

write(eventName: string, eventType: EventType, keyValues: object, callback: AsyncCallback<void>): void

应用事件打点方法，将事件写入到当天的事件文件中，使用callback方式作为异步回调。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

参数：

示例：

hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"}, (err, value) => {
    if (err) {
        // 事件写入异常：事件存在异常参数时忽略异常参数后继续写入，或者事件校验失败时不执行写入
        console.error(`failed to write event because ${err.code}`);
        return;
    }

    // 事件写入正常
    console.log(`success to write event: ${value}`);
});

hiAppEvent.write

write(eventName: string, eventType: EventType, keyValues: object): Promise<void>

应用事件打点方法，将事件写入到当天的事件文件中，使用Promise方式作为异步回调。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

参数：

返回值：

示例：

hiAppEvent.write("test_event", hiAppEvent.EventType.FAULT, {"int_data":100, "str_data":"strValue"})
    .then((value) => {
        // 事件写入正常
        console.log(`success to write event: ${value}`);
    }).catch((err) => {
        // 事件写入异常：事件存在异常参数时忽略异常参数后继续写入，或者事件校验失败时不执行写入
        console.error(`failed to write event because ${err.code}`);
    });

hiAppEvent.configure

configure(config: ConfigOption): boolean

应用事件打点配置方法，可用于配置打点开关、文件目录存储限额大小等功能。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

参数：

返回值：

示例：

// 配置应用事件打点功能开关
hiAppEvent.configure({
    disable: true
});

// 配置事件文件目录存储限额大小
hiAppEvent.configure({
    maxStorage: '100M'
});

ConfigOption

此接口提供了应用打点的配置选项。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

EventType

事件类型枚举。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

Event

此接口提供了所有预定义事件的事件名称常量。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

Param

此接口提供了所有预定义参数的参数名称常量。

系统能力： SystemCapability.HiviewDFX.HiAppEvent

@ohos.statfs (statfs)

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

该模块提供文件系统相关存储信息的功能，向应用程序提供获取文件系统总字节数、空闲字节数的JS接口。

说明

• 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
• 本模块接口从API version 9开始废弃，建议使用​​@ohos.file.statvfs​​替代。

导入模块

import statfs from '@ohos.statfs';

statfs.getFreeBytes

getFreeBytes(path:string):Promise<number>

异步方法获取指定文件系统空闲字节数，以Promise形式返回结果。

系统能力：SystemCapability.FileManagement.File.FileIO

参数：

返回值：

示例：

let path = "/dev";
statfs.getFreeBytes(path).then(function (number) {
    console.info("getFreeBytes promise successfully:" + number);
}).catch(function (err) {
    console.info("getFreeBytes failed with error:" + err);
});

statfs.getFreeBytes

getFreeBytes(path:string, callback:AsyncCallback<number>): void

异步方法获取指定文件系统空闲字节数，使用callback形式返回结果。

系统能力：SystemCapability.FileManagement.File.FileIO

参数：

示例：

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

statfs.getTotalBytes

getTotalBytes(path: string): Promise<number>

异步方法获取指定文件系统总字节数，以Promise形式返回结果。

系统能力：SystemCapability.FileManagement.File.FileIO

参数：

返回值：

示例：

let path = "/dev";
statfs.getTotalBytes(path).then(function (number) {
    console.info("getTotalBytes promise successfully:" + number);
}).catch(function (err) {
    console.info("getTotalBytes failed with error:" + err);
});

statfs.getTotalBytes

getTotalBytes(path: string, callback: AsyncCallback<number>): void

异步方法获取指定文件系统总字节数，使用callback形式返回结果。

系统能力：SystemCapability.FileManagement.File.FileIO

参数：

示例：

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

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-statfs-0000001427902692-V3?catalogVersion=V3​​