IDL file: mozilla-central/source/dom/base/nsIMessageManager.idl
Inherits from: nsIMessageListenerManager
Message "broadcasters" don't have a single "other side" that they send messages to, but rather a set of subordinate message managers. For example, broadcasting a message through a window message manager will broadcast the message to all frame message managers within its window.
See Message Manager interfaces for more details on the distinction between message senders and message broadcasters.
Methods
void broadcastAsyncMessage([optional] in AString messageName, |
nsIMessageListenerManager getChildAt(in unsigned long aIndex); |
broadcastAsyncMessage()
Like sendAsyncMessage()
, but also broadcasts this message to all "child" message managers of this message manager.
See nsIMessageListener::receiveMessage()
for the format of the data delivered to listeners.
WARNING: broadcasting messages can be very expensive and leak sensitive data. Use with extreme caution.
Throws NS_ERROR_NOT_INITIALIZED
if the sender is not initialized. For example, we will throw NS_ERROR_NOT_INITIALIZED
if we try to send a message to a cross-process frame but the other process has not yet been set up.
Throws NS_ERROR_FAILURE
when the message receiver cannot be found. For example, we will throw NS_ERROR_FAILURE
if we try to send a message to a cross-process frame whose process has crashed.
Parameters
Name | Type | Description |
---|---|---|
messageName |
String |
The name of the message. Optional. This becomes the |
obj |
Object. |
The message payload. A structured clone of this becomes the |
objects |
Object. |
An object each of whose properties is an object. This becomes the |
getChildAt()
Return a single subordinate message manager.
Parameters
Name | Type | Description |
---|---|---|
aIndex |
Number | The index of the subordinate message manager to retrieve. |
Returns
: the message manager at the given index.nsIMessageListenerManager
Attributes
childCount
Number
: the number of subordinate message managers. Read only.