harmony(鸿蒙)ErrorManager

2022-10-28
浏览 (707)

ErrorManager

The ErrorManager module provides APIs for registering and deregistering error observers.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import errorManager from '@ohos.application.errorManager'

ErrorManager.registerErrorObserver

registerErrorObserver(observer: ErrorObserver): number;

Registers an error observer.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
observer	ErrorObserver	No	Numeric code of the observer.

Example

var observer = {
    onUnhandledException(errorMsg) {
        console.log('onUnhandledException, errorMsg: ', errorMsg)
    }
}
errorManager.registerErrorObserver(observer)

ErrorManager.unregisterErrorObserver

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

Deregisters an error observer. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
observerId	number	No	Numeric code of the observer.
callback	AsyncCallback<void>	No	Callback used to return the result.

Example

var observerId = 100;

function unregisterErrorObserverCallback(err) {
    if (err) {
        console.log('------------ unregisterErrorObserverCallback ------------', err);
    }
}
errorManager.unregisterErrorObserver(observerId, unregisterErrorObserverCallback);

ErrorManager.unregisterErrorObserver

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

Deregisters an error observer. This API uses a promise to return the result.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
observerId	number	No	Numeric code of the observer.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Example

var observerId = 100;
errorManager.unregisterErrorObserver(observerId)
.then((data) => {
    console.log('----------- unregisterErrorObserver success ----------', data);
})
.catch((err) => {
    console.log('----------- unregisterErrorObserver fail ----------', err);
})

ErrorObserver

onUnhandledException(errMsg: string): void;

Called when an unhandled exception occurs in the JS runtime.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
errMsg	string	No	Message and error stack trace about the exception.

Example

var observer = {
    onUnhandledException(errorMsg) {
        console.log('onUnhandledException, errorMsg: ', errorMsg)
    }
}
errorManager.registerErrorObserver(observer)