@ohos.events.emitter (Emitter)

本模块提供了在同一进程不同线程间，或同一进程同一线程内，发送和处理事件的能力，包括持续订阅事件、单次订阅事件、取消订阅事件，以及发送事件到事件队列的能力。

说明：

本模块首批接口从API version 7开始支持。后续版本新增接口，采用上角标单独标记接口的起始版本。

导入模块

import emitter from '@ohos.events.emitter';

权限列表

无权限要求。

emitter.on

on(event: InnerEvent, callback: Callback<EventData>): void

持续订阅指定的事件，并在接收到该事件时，执行对应的回调处理函数。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

let innerEvent: emitter.InnerEvent = {
  eventId: 1
};

// 收到eventId为1的事件后执行回调函数
emitter.on(innerEvent, () => {
  console.info('callback');
});

emitter.on¹¹⁺

on(eventId: string, callback: Callback<EventData>): void

持续订阅指定事件，并在接收到该事件时，执行对应的回调处理函数。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

// 收到eventId为"eventId"的事件后执行回调函数
emitter.on("eventId", () => {
  console.info('callback');
});

emitter.once

once(event: InnerEvent, callback: Callback<EventData>): void

单次订阅指定的事件，并在接收到该事件并执行完相应的回调函数后，自动取消订阅。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

let innerEvent: emitter.InnerEvent = {
    eventId: 1
};

// 收到eventId为1的事件后执行该回调函数
emitter.once(innerEvent, () => {
    console.info('once callback');
});

emitter.once¹¹⁺

once(eventId: string, callback: Callback<EventData>): void

单次订阅指定事件，并在接收到该事件并执行完相应的回调函数后，自动取消订阅。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

// 收到eventId为"eventId"的事件后执行该回调函数
emitter.once("eventId", () => {
    console.info('once callback');
});

emitter.off

off(eventId: number): void

取消针对该事件ID的订阅。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

// 取消eventID为1的所有事件回调处理函数
emitter.off(1);

emitter.off¹¹⁺

off(eventId: string): void

取消订阅指定事件。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

// 取消eventID为"eventId"的所有事件回调处理函数
emitter.off("eventId");

emitter.off¹⁰⁺

off(eventId: number, callback: Callback<EventData>): void

取消针对该事件ID的订阅，传入可选参数callback，并且该callback已经通过on或者once接口订阅，则取消该订阅；否则，不做任何处理。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

// 取消eventID为1的事件回调处理函数 emitterCallback
// 如果该回调处理函数没有被订阅，则不做任何处理
emitter.off(1, () => {
  console.info('callback');
});

emitter.off¹¹⁺

off(eventId: string, callback: Callback<EventData>): void

取消针对该事件ID的订阅，传入可选参数callback，并且该callback已经通过on或者once接口订阅，则取消该订阅；否则，不做任何处理。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

// 取消eventID为"eventId"的事件回调处理函数 emitterCallback
// 如果该回调处理函数没有被订阅，则不做任何处理
emitter.off("eventId", () => {
  console.info('callback');
});

emitter.emit

emit(event: InnerEvent, data?: EventData): void

发送指定的事件。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

let eventData: emitter.EventData = {
    data: {
        "content": "c",
        "id": 1,
    }
};

let innerEvent: emitter.InnerEvent = {
    eventId: 1,
    priority: emitter.EventPriority.HIGH
};

emitter.emit(innerEvent, eventData);

emitter.emit¹¹⁺

emit(eventId: string, data?: EventData): void

发送指定事件。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

let eventData: emitter.EventData = {
    data: {
        "content": "c",
        "id": 1,
    }
};

emitter.emit("eventId", eventData);

emitter.emit¹¹⁺

emit(eventId: string, options: Options, data?: EventData): void

发送指定优先级事件。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

let eventData: emitter.EventData = {
    data: {
        "content": "c",
        "id": 1,
    }
};

let options: emitter.Options = {
    priority: emitter.EventPriority.HIGH
};

emitter.emit("eventId", options, eventData);

emitter.getListenerCount¹¹⁺

getListenerCount(eventId: number|string): number

获取指定事件的订阅数。

系统能力: SystemCapability.Notification.Emitter

参数：

示例：

let count = emitter.getListenerCount("eventId");

EventPriority

用于表示事件被发送的优先级。

系统能力: SystemCapability.Notification.Emitter

InnerEvent

订阅或发送的事件，订阅事件时EventPriority不生效。

系统能力: SystemCapability.Notification.Emitter

EventData

发送事件时传递的数据。

系统能力: SystemCapability.Notification.Emitter

Options¹¹⁺

发送事件的优先级。

系统能力: SystemCapability.Notification.Emitter