diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md index 98618d10e6b6c3629f51ad15dbfe0c17e609d1ff..8a547b7101c1e397ba7bda4a157a4d0eaa42b5c7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md @@ -156,3 +156,77 @@ try { } ``` +## Context.getGroupDir10+ + +getGroupDir(groupId: string): Promise\; + +通过使用元服务应用中的Group ID获取对应的共享目录,使用Promise异步回调。 + +**系统能力**:SystemCapability.Ability.AbilityRuntime.Core + +**参数:** + +| 名称 | 类型 | 必填 | 说明 | +| -------- | ---------------------- | ---- | ------------- | +| groupId | string | 是 | 元服务应用项目创建时,系统会指定分配唯一Group ID。 | + +**返回值:** + +| 类型 | 说明 | +| -------- | -------- | +| Promise\ | 以Promise方式返回对应的共享目录。如果不存在则返回为空,仅支持应用el2加密级别。| + +**错误码**: + +以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000011 | The context does not exist. | + +**示例:** + +```ts +let groupId = "1"; +context.getGroupDir(groupId).then(data => { + console.log("getGroupDir result:" + data); +}).catch((err) => { + console.error('error: ${JSON.stringify(err)}'); +}); +``` + +## Context.getGroupDir10+ + +getGroupDir(groupId: string, callback: AsyncCallback\); + +通过使用元服务应用中的Group ID获取对应的共享目录,使用callback异步回调。 + +**系统能力**:SystemCapability.Ability.AbilityRuntime.Core + +**参数:** + +| 名称 | 类型 | 必填 | 说明 | +| -------- | ---------------------- | ---- | ------------- | +| groupId | string | 是 | 元服务应用项目创建时,系统会指定分配唯一Group ID。 | +| callback | AsyncCallback\ | 是 | 以callback方式返回对应的共享目录。如果不存在则返回为空,仅支持应用el2加密级别。| + +**错误码**: + +以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 16000011 | The context does not exist. | + +**示例:** + +```ts +context.getGroupDir("1", (err, data) => { + if (err) { + console.error('getGroupDir faile, err: ${JSON.stringify(err)}'); + } else { + console.log('getGroupDir result is: ${JSON.stringify(data)}'); + } +}); +``` +