1# @ohos.base (公共回调信息)
2
3本模块定义了OpenHarmony ArkTS接口的公共回调类型,包括接口调用时出现的公共回调和公共错误信息。
4
5> **说明:**
6>
7> - 本模块首批接口从 API version 6 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8>
9> - 从API version 12开始,本模块接口支持在ArkTS卡片中使用。
10
11## 导入模块
12
13```
14import base from '@ohos.base';
15```
16
17## Callback
18
19Callback\<T> {
20
21(data: T): void;
22
23}
24
25通用回调函数。
26
27开发者在使用时,可自定义data的类型,回调将返回对应类型的信息。
28
29**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
30
31**系统能力:** SystemCapability.Base
32
33| 名称 | 类型 | 必填 | 说明                       |
34| ---- | ---- | ---- | -------------------------- |
35| data | T    | 是   | 接口调用时的公共回调信息。 |
36
37## ErrorCallback
38
39ErrorCallback\<T extends Error = BusinessError> {
40
41(err: T): void;
42
43}
44
45通用回调函数,携带错误参数。
46
47回调返回的信息为[BusinessError](#businesserror)类型的信息。
48
49**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
50
51**系统能力:** SystemCapability.Base
52
53**参数:**
54
55| 名称 | 类型 | 必填 | 说明                         |
56| ---- | ---- | ---- | ---------------------------- |
57| err  | T    | 是   | 接口调用失败的公共错误信息。 |
58
59## AsyncCallback
60
61AsyncCallback\<T, E = void> {
62
63(err: BusinessError\<E>, data: T): void;
64
65}
66
67通用回调函数,携带错误参数和异步返回值。
68
69错误参数为[BusinessError](#businesserror)类型的信息。
70
71异步返回值的类型由开发者自定义,回调将返回对应类型的信息。
72
73**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
74
75**系统能力:** SystemCapability.Base
76
77| 名称 | 类型                                                         | 必填 | 说明                         |
78| ---- | ------------------------------------------------------------ | ---- | ---------------------------- |
79| err  | [BusinessError](#businesserror) | 是   | 接口调用失败的公共错误信息。 |
80| data | T                                                            | 是   | 接口调用时的公共回调信息。   |
81
82## BusinessError
83
84BusinessError\<T = void> extends Error {
85
86code: number;
87
88data?: T;
89}
90
91错误参数。
92
93**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
94
95**系统能力:** SystemCapability.Base
96
97| 名称 | 类型   | 必填 | 说明                                                       |
98| ---- | ------ | ---- | ---------------------------------------------------------- |
99| code | number | 是   | 接口调用失败返回的错误码信息。                             |
100| data | T      | 否   | 接口调用时的公共回调信息。如果不填,则回调不返回相关信息。 |