This article needs a technical review. How you can help.
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.
sendAsyncMessage(), but also broadcasts this message to all "child" message managers of this message manager.
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.
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.
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.
The name of the message. Optional.
This becomes the
The message payload.
A structured clone of this becomes the
An object each of whose properties is an object.
Return a single subordinate message manager.
||Number||The index of the subordinate message manager to retrieve.|
: the message manager at the given index.
Number: the number of subordinate message managers. Read only.