• Skip to main content
  • Select language
  • Skip to search
MDN Web Docs
  • Technologies
    • HTML
    • CSS
    • JavaScript
    • Graphics
    • HTTP
    • APIs / DOM
    • WebExtensions
    • MathML
  • References & Guides
    • Learn web development
    • Tutorials
    • References
    • Developer Guides
    • Accessibility
    • Game development
    • ...more docs
B2G OS
  1. MDN
  2. Archive of obsolete content
  3. B2G OS
  4. B2G OS APIs
  5. Mobile Messaging API

Mobile Messaging API

In This Article
  1. Summary
  2. DOM interfaces
    1. SMS interfaces
    2. MMS and SMS interfaces
  3. Sample code and introduction
  4. Specifications
  5. Browser compatibility
  6. Preferences & availability
  7. See also

Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

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

Summary

WebSMS is an API that makes it possible for web content to create, send, and receive Short Message Service (SMS) or Multimedia Messaging Service (MMS) messages.

The API is available using Navigator.mozSms which returns a MozSmsManager object or Navigator.mozMobileMessage which returns a MozMobileMessageManager. See below for a full list of interfaces:

DOM interfaces

SMS interfaces

  • Navigator.mozSms Deprecated since Gecko 25
  • MozSmsManager Deprecated since Gecko 25
  • MozSmsMessage
  • MozSmsEvent
  • MozSmsFilter
  • MozSmsSegmentInfo

MMS and SMS interfaces

  • Navigator.mozMobileMessage Requires FirefoxOS 1.1
  • MozMobileMessageManager
  • MozMmsMessage
  • MozMmsEvent
  • MozMobileMessageThread

Sample code and introduction

  • Introduction to Mobile Message API

Specifications

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.

  • Desktop
  • Mobile
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support No support No support No support No support No support
Feature Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support No support 12.0 (12.0) 1.0.1
1.1 for MMS
No support No support No support

Preferences & availability

  • WebSMS is disabled by default and can be enabled setting the preference dom.sms.enabled to true.
  • A comma-separated whitelist of allowed hostnames that are allowed to use the WebSMS API must be specified using the dom.sms.whitelist preference. This string is empty by default.
  • WebSMS is only available to certified apps on Firefox OS (B2G).
  • MMS are available starting with Firefox OS 1.1

See also

  • WebSMS API (design document)

Document Tags and Contributors

Tags: 
  • API
  • Firefox OS
  • Non-standard
  • Reference
 Contributors to this page: chrisdavidmills, teoli, kscarfone, Crystalavila87, Jeremie, Sheppy, fscholz
 Last updated by: chrisdavidmills, Feb 27, 2017, 2:07:17 AM
See also
  1. Mobile Messaging API
  2. Interfaces
    1. MozSmsManager
    2. MozSmsMessage
    3. MozSmsEvent
    4. MozSmsFilter
    5. MozSmsSegmentInfo
    6. MozMobileMessageManager
    7. MozMmsMessage
    8. MozMmsEvent
    9. MozMobileMessageThread
  3. Properties
    1. Navigator.mozMobileMessage
    2. Navigator.mozSMS
  4. Events
    1. open
    2. message
    3. error
    4. close
    5. sending
    6. sent
    7. failed
    8. deliverysuccess
    9. deliveryerror
    10. retrieving
    11. received