Unsubscribing from Common Events in Dynamic Mode

When to Use

You can call unsubscribe() to unsubscribe from a common event that is no longer required in dynamic mode.

Available APIs

API Description
unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback) Unsubscribes from a common event.

How to Develop

  1. Import the commonEventManager module.

    import commonEventManager from '@ohos.commonEventManager';
    import Base from '@ohos.base';
    
  2. Subscribe to an event by following the procedure described in Subscribing to Common Events in Dynamic Mode.

  3. Call unsubscribe in CommonEvent to unsubscribe from the common event.

    // The subscriber object is created during event subscription.
    if (subscriber !== null) {
        commonEventManager.unsubscribe(subscriber, (err: Base.BusinessError) => {
            if (err) {
                console.error(`[CommonEvent] UnsubscribeCallBack err=${JSON.stringify(err)}`);
            } else {
                console.info(`[CommonEvent] Unsubscribe`);
                subscriber = null;
            }
        })
    }