• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.errorManager (ErrorManager)
2
3ErrorManager模块提供对错误观察器的注册和注销的能力。
4
5> **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10```
11import errorManager from '@ohos.app.ability.errorManager'
12```
13
14## ErrorManager.on
15
16on(type: 'error', observer: ErrorObserver): number;
17
18注册错误观测器。
19
20**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
21
22**参数：**
23
24| 参数名 | 类型 | 必填 | 说明 |
25| -------- | -------- | -------- | -------- |
26| type | string | 是 | 调用接口类型 |
27| observer | [ErrorObserver](./js-apis-inner-application-errorObserver.md) | 是 | 返回观察者的数字代码。 |
28
29**示例：**
30
31```js
32let observer = {
33    onUnhandledException(errorMsg) {
34        console.log('onUnhandledException, errorMsg: ', errorMsg)
35    }
36};
37try {
38    errorManager.on('error', observer);
39} catch (paramError) {
40    console.log('error: ' + paramError.code + ', ' + paramError.message);
41}
42```
43
44## ErrorManager.off
45
46off(type: 'error', observerId: number,  callback: AsyncCallback\<void>): void;
47
48注销错误观测器。
49
50**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
51
52**参数：**
53
54| 参数名 | 类型 | 必填 | 说明 |
55| -------- | -------- | -------- | -------- |
56| type | string | 是 | 调用接口类型 |
57| observerId | number | 是 | 返回观察者的数字代码。 |
58| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
59
60**示例：**
61
62```js
63let observerId = 100;
64
65function unregisterErrorObserverCallback(err) {
66    if (err) {
67        console.log('------------ unregisterErrorObserverCallback ------------', err);
68    }
69}
70try {
71    errorManager.off('error', observerId, unregisterErrorObserverCallback);
72} catch (paramError) {
73    console.log('error: ' + paramError.code + ', ' + paramError.message);
74}
75```
76
77## ErrorManager.off
78
79off(type: 'error', observerId: number): Promise\<void>;
80
81注销错误观测器。
82
83**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
84
85**参数：**
86
87| 参数名 | 类型 | 必填 | 说明 |
88| -------- | -------- | -------- | -------- |
89| type | string | 是 | 调用接口类型 |
90| observerId | number | 是 | 返回观察者的数字代码。 |
91
92**返回值：**
93
94| 类型 | 说明 |
95| -------- | -------- |
96| Promise\<void> | 返回执行结果。 |
97
98**示例：**
99
100```js
101let observerId = 100;
102try {
103    errorManager.off('error', observerId)
104        .then((data) => {
105            console.log('----------- unregisterErrorObserver success ----------', data);
106        })
107        .catch((err) => {
108            console.log('----------- unregisterErrorObserver fail ----------', err);
109    });
110} catch (paramError) {
111    console.log('error: ' + paramError.code + ', ' + paramError.message);
112}
113
114```
115