MozMobileMessageManager

Summary

Provides support for sending and managing both MMS and SMS messages on a device with WebSMS.

Event Handlers

MozMobileMessageManager.ondeliveryerror

A handler for a deliveryerror event; this MozMmsEvent or MozSmsEvent is sent whenever an MMS or SMS is not delivered to a recipient.

MozMobileMessageManager.ondeliverysuccess

A handler for a deliverysuccess event; this MozMmsEvent or MozSmsEvent is sent whenever an MMS or SMS is delivered to a recipient.

MozMobileMessageManager.onreceived

A handler for a received event; this MozMmsEvent or MozSmsEvent is sent whenever an MMS or SMS is received.

MozMobileMessageManager.onretrieving

A handler for a retrieving event; this MozMmsEvent or MozSmsEvent is sent whenever an MMS or SMS enters the retrieving flow.

MozMobileMessageManager.onsent

A handler for a sent event; this MozMmsEvent or MozSmsEvent is sent whenever an MMS or SMS is sent.

MozMobileMessageManager.onsending

A handler for a sending event; this MozMmsEvent or MozSmsEvent is sent whenever an MMS or SMS enters the send flow.

MozMobileMessageManager.onfailed

A handler for a failed event; this MozMmsEvent or MozSmsEvent is sent when sending an MMS or SMS has failed.

Methods

MozMobileMessageManager.delete(param)

Deletes a message and returns a DOMRequest object (where DOMRequest.result is a Boolean reflecting whether the message was deleted). A message id,  an array of message id, a MozSmsMessage object or an array of this, or a MozMmsMessage object or an array of this can be used as a parameter.

MozMobileMessageManager.getMessage(id)

Gets a message with the specified id and returns a DOMRequest object where DOMRequest.result is a MozSmsMessage.

MozMobileMessageManager.getMessages(filter, reverseOrder)

Gets messages, which are specified using an MozSmsFilter object. The order can be reversed using a boolean as a second parameter. A DOMCursor is returned.

MozMobileMessageManager.getSegmentInfoForText(text)

Returns a MozSmsSegmentInfo with the information necessary to create a multi-part SMS for a given text (usually 160 characters per SMS).

MozMobileMessageManager.markMessageRead(id, isRead)

Marks a message with the specified id as read or unread depending on the Boolean isRead. A DOMRequest object is returned.

MozMobileMessageManager.send(number, message)

Sends a message to a specified number. If number is a DOMString (only one number) a DOMRequest object is returned. If number is an array of DOMStrings (multiple numbers) an array of DOMRequest objects is returned.

MozMobileMessageManager.sendMMS(param)

Send an MMS to a list of receivers. A DOMRequest object is returned The param object is a regular JavaScript object with four properties:

• receivers: An array of strings, each string representing the phone number of a receiver.
• subject: A string representing the subject of the MMS.
• smil: A stringified version of the SMIL document defining the MMS.
• attachments: An array of attachment objects used by the SMIL document. Those objects contain an id, a location, and a content which is a Blob.

MozMobileMessageManager.getThreads()

Gets a list of MozMobileMessageThread. A DOMCursor is returned.

MozMobileMessageManager.retrieveMMS(id)

Gets a message with the specified id and returns a DOMRequest object where DOMRequest.result is a MozMmsMessage.

MozMobileMessageManager.getSmscAddress()

Gets the number of the SMS center for the specificed SIM card and returns a DOMRequest object where DOMRequest.result is the number.

Specifications

This is a nonstandard implementation, but it is discussed at W3C as part of the System Application Working Group.

Browser compatibility

For obvious reasons, support is primarily expected on mobile browsers.

See also

• window.navigator.mozMobileMessage
• MozMmsEvent