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