# AppManager

**Kind**: interface | **Module**: [App Management](https://docs.interop.io/desktop/reference/javascript/app%20management/index.md)

**Source**: https://docs.interop.io/desktop/reference/javascript/app management/appmanager/index.html

App Management API that allows you to handle your interop-enabled apps.

## Methods

### application

Retrieves an app by name.

```ts
(name: string) => Application | undefined
```

**Parameters**

- **`name`** (`string`, required)
  Name of the desired app.

**Returns**: `Application | undefined`

### applications

Retrieves a collection of the available apps.

```ts
() => Application[]
```

**Returns**: `Application[]`

### getConfigurations

Retrieves the configurations of the specified apps.

```ts
(apps?: string[]) => Promise<Definition[]>
```

**Parameters**

- **`apps`** (`string[]`, optional)
  List of names of the apps for which to retrieve configurations.

**Returns**: `Promise<Definition[]>`

### getConfigurations

```ts
(apps: string[]) => Promise<Record<string, any>>
```

**Parameters**

- **`apps`** (`string[]`, required)

**Returns**: `Promise<Record<string, any>>`

### instances

Retrieves a collection of all running app instances.

```ts
() => Instance[]
```

**Returns**: `Instance[]`

### onAppAdded

Notifies when an app is registered in the environment.

```ts
(callback: (app: Application) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(app: Application) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onAppAvailable

Notifies when an app is available and can be started.

```ts
(callback: (app: Application) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(app: Application) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onAppChanged

Notifies when the configuration for an app has changed.

```ts
(callback: (app: Application) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(app: Application) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onAppRemoved

Notifies when an app is removed from the environment.

```ts
(callback: (app: Application) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(app: Application) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onAppUnavailable

Notifies when an app is no longer available and can't be started.

```ts
(callback: (app: Application) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(app: Application) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onInstanceStarted

Notifies when a new app instance is started.

```ts
(callback: (instance: Instance) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(instance: Instance) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onInstanceStartFailed

Notifies when starting a new app instance has failed.

```ts
(callback: (instance: Instance) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(instance: Instance) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onInstanceStopped

Notifies when an app instance is stopped.

```ts
(callback: (instance: Instance) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(instance: Instance) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

### onInstanceUpdated

Notifies when an app instance is updated.

```ts
(callback: (instance: Instance) => any) => UnsubscribeFunction
```

**Parameters**

- **`callback`** (`(instance: Instance) => any`, required)
  Callback function for handling the event.

**Returns**: `UnsubscribeFunction`

## Related types

- [Application](https://docs.interop.io/desktop/reference/javascript/app%20management/application/index.md)
- [Definition](https://docs.interop.io/desktop/reference/javascript/app%20management/definition/index.md)
- [Instance](https://docs.interop.io/desktop/reference/javascript/app%20management/instance/index.md)
- [UnsubscribeFunction](https://docs.interop.io/desktop/reference/javascript/search/unsubscribefunction/index.md)