Message senders enable clients to send asynchronous messages to a single "other side". For example, a child-process message manager will send messages that are only delivered to its one parent-process message manager.
To send messages to multiple "other sides", you would use
See Message Manager interfaces for more details on the distinction between message senders and message broadcasters.
obj to the "other side" of this message manager. This invokes listeners who registered for
messageName using a
nsIMessageListener::receiveMessage() for the format of the data delivered to listeners.
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.