1# RunningMultiAppInfo (System API)
2
3The RunningMultiAppInfo module defines the information of an application in multi-app mode in the running state.
4
5> **NOTE**
6>
7> The initial APIs of this module are supported since API version 12. Newly added APIs will be marked with a superscript to indicate their earliest API version.
8>
9> The APIs provided by this module are system APIs.
10
11## Properties
12
13**System API**: This is a system API.
14
15**System capability**: SystemCapability.Ability.AbilityRuntime.Core
16
17| Name                     | Type  | Mandatory | Description      |
18| ------------------------- | ------ | ---- | --------- |
19| bundleName | string | Yes | Bundle name of the application.|
20| mode | [MultiAppMode](js-apis-inner-application-multiAppMode-sys.md) | Yes  | Multi-app mode.|
21| runningAppClones | Array<[RunningAppClone](js-apis-inner-application-runningAppClone-sys.md)> | No | Information about application clones with the specific bundle name in the running state.|
22| runningMultiInstances<sup>14+</sup> | Array<[RunningMultiInstanceInfo](js-apis-inner-application-runningMultiInstanceInfo-sys.md)> | No | Information about a multi-instance application with the specific bundle name in the running state.|
23
24## How to Use
25
26The **RunningMultiAppInfo** struct is obtained from [getRunningMultiAppInfo](js-apis-app-ability-appManager-sys.md#appmanagergetrunningmultiappinfo12) of **appManager**.
27
28**Example**
29
30```ts
31import { appManager } from '@kit.AbilityKit';
32import { hilog } from '@kit.PerformanceAnalysisKit';
33import { BusinessError } from '@kit.BasicServicesKit';
34
35try {
36  let bundleName = "ohos.samples.etsclock";
37  appManager.getRunningMultiAppInfo(bundleName).then((info: RunningMultiAppInfo) => {
38      hilog.info(0x0000, 'testTag', `getRunningMultiAppInfo success`);
39    }).catch((err: BusinessError) => {
40      hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
41    })
42} catch (err) {
43  hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
44}
45```
46