We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

SmsManager Redirect 1

« DOM Reference

This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Obsolete since Gecko 25 (Firefox 25 / Thunderbird 25 / SeaMonkey 2.22)
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

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

Note: As of Gecko 25.0, this interface has been removed in favor of MozMobileMessageManager.


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

Event Handlers

A handler for a deliveryerror event; this MozSmsEvent is sent whenever an SMS is not delivered to a recipient.
A handler for a deliverysuccess event; this MozSmsEvent is sent whenever an SMS is delivered to a recipient.
A handler for a received event; this MozSmsEvent is sent whenever an SMS is received.
A handler for a sent event; this MozSmsEvent is sent whenever an SMS is sent.
A handler for a sending event; this MozSmsEvent is sent whenever an SMS enters the send flow.
A handler for a failed event; this MozSmsEvent is sent when sending an SMS has failed.


Deletes a message and returns a DOMRequest object (where DOMRequest.result is a Boolean reflecting whether the message was deleted). A message id or an MozSmsMessage object can be used as a parameter.
Gets a message with the specified id and returns a DOMRequest object where DOMRequest.result is a MozSmsMessage.
MozSmsManager.getMessages(filter, reverseOrder)
Gets messages, which are specified using a MozSmsFilter object. The order can be reversed using a boolean as a second parameter. A DOMCursor is returned.
Returns a MozSmsSegmentInfo with the information necessary to create a multi-part SMS for a given text (usually 160 characters per SMS).
MozSmsManager.markMessageRead(id, isRead)
Marks a message with the specified id as read or unread depending on the Boolean isRead. A DOMRequest object is returned.
MozSmsManager.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.
Gets a list of MozMobileMessageThread. A DOMCursor is returned.

MozSmsManager also inherits the methods from EventTarget.

Register an event handler of a specific event type on the EventTarget.
Removes an event listener from the EventTarget.
Dispatch an event to this EventTarget.


This is a non standard 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).

Browser compatibility

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

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support Not supported Not supported Not supported Not supported Not supported
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support Not supported 12.0 (12.0) Moz Not supported Not supported Not supported

See also

Document Tags and Contributors

Last updated by: Sheppy,