harmony 鸿蒙@ohos.base (公共回调信息)

  • 2025-06-12
  • 浏览 (4)

@ohos.base (公共回调信息)

本模块定义了OpenHarmony ArkTS接口的公共回调类型,包括接口调用时出现的公共回调和公共错误信息。

说明:

  • 本模块首批接口从 API version 6 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

  • 从API version 12开始,本模块接口支持在ArkTS卡片中使用。

导入模块

import base from '@ohos.base';

Callback

Callback<T> {

(data: T): void;

}

通用回调函数。

开发者在使用时,可自定义data的类型,回调将返回对应类型的信息。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Base

名称 类型 必填 说明
data T 接口调用时的公共回调信息。

ErrorCallback

ErrorCallback<T extends Error = BusinessError> {

(err: T): void;

}

通用回调函数,携带错误参数。

回调返回的信息为BusinessError类型的信息。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Base

参数:

名称 类型 必填 说明
err T 接口调用失败的公共错误信息。

AsyncCallback

AsyncCallback<T, E = void> {

(err: BusinessError<E>, data: T): void;

}

通用回调函数,携带错误参数和异步返回值。

错误参数为BusinessError类型的信息。

异步返回值的类型由开发者自定义,回调将返回对应类型的信息。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Base

名称 类型 必填 说明
err BusinessError 接口调用失败的公共错误信息。
data T 接口调用时的公共回调信息。

BusinessError

BusinessError<T = void> extends Error {

code: number;

data?: T; }

错误参数。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Base

名称 类型 必填 说明
code number 接口调用失败返回的错误码信息。
data T 接口调用时的公共回调信息。如果不填,则回调不返回相关信息。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Basic Services Kit(基础服务)

harmony 鸿蒙DeviceInfo

harmony 鸿蒙OH_Print

harmony 鸿蒙Print_Margin

harmony 鸿蒙Print_PageSize

harmony 鸿蒙Print_PrintAttributes

harmony 鸿蒙Print_PrintDocCallback

harmony 鸿蒙Print_Range

harmony 鸿蒙TimeService

harmony 鸿蒙ohscan.h

0  赞