MozMobileMessageManager

This API is available on Firefox OS for internal applications only.

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.

Specification Status Comment
Messaging API Editor's Draft Editor Draft (WIP).

See also