js-apis-application-errorManager.md 2.5 KB
Newer Older
1 2 3 4 5 6
# ErrorManager

ErrorManager模块提供对错误观察器的注册和注销的能力。

> **说明:**
> 
D
donglin 已提交
7
> 本模块首批接口从API version 9开始支持,从API version 9后续版本废弃,替换模块为[@ohos.app.ability.errorManager](js-apis-app-ability-errorManager.md)。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8 9

## 导入模块
M
m00512953 已提交
10
```ts
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
import errorManager from '@ohos.application.errorManager'
```

## ErrorManager.registerErrorObserver

registerErrorObserver(observer: ErrorObserver): number;

注册错误观测器。

**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**参数:**
 
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
D
merge  
donglin 已提交
26
| observer | [ErrorObserver](js-apis-inner-application-errorObserver.md) | 是 | 返回观察者的数字代码。 |
27 28 29

**示例:**
    
M
m00512953 已提交
30
```ts
31 32 33 34 35
var observer = {
    onUnhandledException(errorMsg) {
        console.log('onUnhandledException, errorMsg: ', errorMsg)
    }
}
Y
yuyaozhi 已提交
36
errorManager.registerErrorObserver(observer)
37 38 39 40 41 42 43 44 45 46 47 48 49 50
```

## ErrorManager.unregisterErrorObserver

unregisterErrorObserver(observerId: number,  callback: AsyncCallback\<void>): void;

注销错误观测器。

**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**参数:**
 
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
51 52
| observerId | number | 是 | 返回观察者的数字代码。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
53 54 55

**示例:**
    
M
m00512953 已提交
56
```ts
57 58
var observerId = 100;

59
function unregisterErrorObserverCallback(err) {
60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
    if (err) {
        console.log('------------ unregisterErrorObserverCallback ------------', err);
    }
}
errorManager.unregisterErrorObserver(observerId, unregisterErrorObserverCallback);

```

## ErrorManager.unregisterErrorObserver

unregisterErrorObserver(observerId: number): Promise\<void>;

注销错误观测器。

**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**参数:**
 
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
80
| observerId | number | 是 | 返回观察者的数字代码。 |
81 82 83 84 85 86 87 88 89

**返回值:**

| 类型 | 说明 |
| -------- | -------- |
| Promise\<void> | 返回执行结果。 |

**示例:**
    
M
m00512953 已提交
90
```ts
91 92 93 94 95 96 97 98 99 100
var observerId = 100;
errorManager.unregisterErrorObserver(observerId)
.then((data) => {
    console.log('----------- unregisterErrorObserver success ----------', data);
})
.catch((err) => {
    console.log('----------- unregisterErrorObserver fail ----------', err);
})

```