1# AutoStartupCallback (System API)
2
3The **AutoStartupCallback** module defines the callback to be invoked when auto-startup is set or canceled for an application component.
4
5> **NOTE**
6>
7> The initial APIs of this module are supported since API version 11. Newly added APIs will be marked with a superscript to indicate their earliest API version.
8>
9> The APIs of this module can be used only in the stage model.
10> The APIs provided by this module are system APIs.
11
12## AutoStartupCallback.onAutoStartupOn
13
14onAutoStartupOn(info: AutoStartupInfo): void;
15
16Called when auto-startup is set for an application component.
17
18**System API**: This is a system API.
19
20**System capability**: SystemCapability.Ability.AbilityRuntime.Core
21
22**Parameters**
23
24| Name | Type | Mandatory | Description |
25| -------- | -------- | -------- | -------- |
26| info | [AutoStartupInfo](js-apis-inner-application-autoStartupInfo-sys.md)   | Yes | Information about the target application component. |
27
28**Example**
29
30```ts
31import { autoStartupManager, common } from '@kit.AbilityKit';
32import { BusinessError } from '@kit.BasicServicesKit';
33
34let autoStartupCallback: common.AutoStartupCallback = {
35  onAutoStartupOn(data: common.AutoStartupInfo) {
36    console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
37  },
38  onAutoStartupOff(data: common.AutoStartupInfo) {
39    console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
40  }
41}
42
43try {
44  autoStartupManager.on('systemAutoStartup', autoStartupCallback)
45} catch (err) {
46  console.info('===> autostartupmanager on callback err: ' + JSON.stringify(err as BusinessError));
47}
48```
49
50## AutoStartupCallback.onAutoStartupOff
51
52onAutoStartupOff(info: AutoStartupInfo): void;
53
54Called when the auto-startup setting of an application component is canceled.
55
56**System API**: This is a system API.
57
58**System capability**: SystemCapability.Ability.AbilityRuntime.Core
59
60**Parameters**
61
62| Name | Type           | Mandatory | Description                |
63| ------ | --------------- | ---- | -------------------- |
64| info   | [AutoStartupInfo](js-apis-inner-application-autoStartupInfo-sys.md)   | Yes  | Information about the target application component. |
65
66**Example**
67
68```ts
69import { autoStartupManager, common } from '@kit.AbilityKit';
70import { BusinessError } from '@kit.BasicServicesKit';
71
72let autoStartupCallback: common.AutoStartupCallback = {
73  onAutoStartupOn(data: common.AutoStartupInfo) {
74    console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
75  },
76  onAutoStartupOff(data: common.AutoStartupInfo) {
77    console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
78  }
79}
80
81try {
82  autoStartupManager.on('systemAutoStartup', autoStartupCallback)
83} catch (err) {
84  console.info('===> autostartupmanager on callback err: ' + JSON.stringify(err as BusinessError));
85}
86```
87