API documentation status overview

As documentation is moving forward, this page will be updated accordingly: APIs that are fully documented are pushed at the bottom of the page and ongoing documentation is put on top.

Ongoing documentation work

See the WebAPI doc schedule for details on our schedule for completing this content.

Update Required

The support for Promise as been landed (bug 856410). When turn on on B2G (bug 897913), it will have many impacts on Web APIs' documentation. This need to be tracked carfully.

API Name Entry Points Bugs Doc status Notes
WebTelephony (support for Conf Call) Tag: bug 772765 Needs extension and update Landed FxOS 1.2 only. Certified Apps only
Network Stats API Tag: bug 858003
bug 858005
bug 887699
Needs update Not landed yet
Notification API Notification.get

Tag:
bug 899574 Needs update Not landed yet

Network APIs

API Name Entry Points Bugs Doc status Notes
Mobile Connection API navigator.mozMobileConnection
MozMobileConnection
MozMobileConnectionInfo
MozMobileICCInfo
MozMobileNetworkInfo
MozMobileCFInfo
MozMobileCellInfo
Introductory article: Mobile Connection

Paused:
MozIccManager
MozStkCommandEvent

Tag: none yet
bug 729173
bug 857414
partial Paused: The STK stack is a big piece and needs further investigation. It doesn't look like a high priority API to document.

Tech review of everything not related to STK asked to Vicamo Yang and Ken Chang.

MXR: MobileConnection
WikiMo: WebMobileConnection

Data Management APIs

API Name Entry Points Bugs Doc status Notes
IndexedDB window.indexedDB
IndexedDB root page: /IndexedDB
bug 553412 almost done The whole documentation lives under /IndexedDB. Shouldn't we moved it under /Web ?

We are waiting the end of the switch to WebIDL to update the documentation

Spec: http://www.w3.org/TR/IndexedDB/ (the draft is more accurate)

Other APIs

API Name Entry Points Bugs Doc status Notes
Inter-App communication API   bug 876397 none WikiMo: Inter-App Communication
Open WebApps   bug 697006 almost done Needs some clean up
Voicemail API window.navigator.mozVoicemail
MozVoicemail
MozVoicemailEvent
MozVoicemailStatus

Tag:
bug 773068 Partial The basic reference documentation is okay but it still need some proper introductory article. It also requires to make the difference between the FxOS 1.0 and 1.3 API (enhancement for multi-sim cards)

WikiMo: WebVoicemail, WebVoicemail (multi SIM)
Microphone API   bug 894848 none Landed in B2G 1.2

Implementation in progress

Those are APIs in progress. They are NOT ready to be documented yet.

API Name Entry Points Bugs Doc status Notes
AudioChannels   bug 1113086
bug 876631
none WikiMo: AudioChannels
DataStore   bug 871445 none WikiMo: DataStore
Virtual Keyboard API   bug 737110 none WikiMo: KeboardIME
WebNFC   bug 674741 none WikiMo: WebNFC
WebUSB   bug 674718 none WikiMo: WebUSB
Speaker Manager API   bug 854753 none WikiMo: unknown
FM RDS (extension of FM API)   bug 864327 none WebAPI forum
ServiceWorker API   bug 903441 none Github

Documentation complete

Web content or installed APIs

API Name Entry Points Bugs Doc status Notes
Alarm API navigator.mozAlarms
MozAlarmsManager
Introductory article: Alarm

Tag:
bug 749551 done Needs editorial review and technical review.

Discuss with Mounir and Genelian about the spec. It is not stable enough to plan any change in the current implementation.

Spec: http://www.w3.org/TR/web-alarms/
MXR: MozAlarmsManager
WikiMo: AlarmAPI
Ambient Light Events DeviceLightEvent
window.ondevicelight
devicelight event
Introductory article: Using Light Events

Tag:

Postoned documentation because the API is at risk:
LightLevelEvent
window.onlightlevel
lightlevel event
bug 738465
bug 842952
done Discussed with Doug Turner about the state of the spec and the implementation of LightLevelEvent: even if it's not implemented yet, we should document the LightLevelEvent interface

Discussed with Annvek the opportunity to drop LightLevelEvent from the spec.

Spec: http://www.w3.org/TR/ambient-light/ (the draft is more accurate)
MXR: DeviceLightEvent
Battery Status API navigator.battery
BatteryManager
chargingchange event
chargingtimechange event
dischargingtimechange event
levelchange event
Introductory article: Battery Status

Tag:
bug 678694 done Don't be fooled by the BatteryManager red link, it's just due to migration from DOM to Web/API within the domxref template.

Needs editorial review

Spec: http://www.w3.org/TR/battery-status/ (the draft is more accurate)
MXR: BatteryManager
Device Orientation DeviceOrientationEvent
DeviceMotionEvent
window.ondeviceorientation
window.ondevicemotion
deviceorientation event
devicemotion event
Introductory article: Detecting device orientation

Tag:

Unimplemented but in the spec
window.oncompassneedscalibration
compassneedscalibration event
bug 615597 done The introductory still need a quick technical review.

Spec: http://www.w3.org/TR/orientation-event/ (the draft is more accurate)
MXR: DeviceOrientationEvent, DeviceMotion
WikiMo: ScreenOrientation
FileHandle API FileHandle
LockedFile
FileRequest
Introductory article: FileHandle API

Tag:
bug 726593 done Still need technical review

IDBDatabase.mozCreateFileHandle need to be documented but it is not urgent as it is a transitory API and it does not do anything special (it's just a factory to get FileHandle objects)

Spec(?): http://dev.w3.org/2006/webapi/FileAPI/ http://w3c.github.io/filesystem-api/Overview.html
MXR: FileHandle, LockedFile, FileRequest
WikiMo: FileHandleAPI
Geolocation API NavigatorGeolocation (incl. methods/properties)
Geolocation (incl. methods/properties)
Position (incl. methods/properties)
Coordinates (incl. methods/properties)
PositionError (incl. methods/properties)
PositionOptions (incl. methods/properties)
Introductory article: Using geolocation

Tag:
  done Editorial review complete.

Spec: http://www.w3.org/TR/geolocation-API/

Maybe add basic examples?
Network Information API NetworkInformation.connection
NetworkInformation
Introductory article: Network Information

Tag:

bug 677166 bug 713199
bug 960426
 

done Spec: http://w3c.github.io/netinfo/
MXR: Connection
Notification API Notification
Introductory article: Using Web Notifications

Tag:
bug 782211 done Spec: http://www.w3.org/TR/notifications/ (W3C draft, WHATWG draft)
MXR: Notification
Pointer Lock API Element.requestPointerLock()
Document.pointerLockElement
Document.exitPointerLock()
MouseEvent
MouseEvent.movementX
MouseEvent.movementY
Introductory article: Pointer Lock API

Tag:
 
bug 633602 done Spec: http://www.w3.org/TR/pointerlock/ (the draft is more accurate)
Proximity Events DeviceProximityEvent
UserProximityEvent
window.ondeviceproximity
window.onuserproximity
deviceproximity event
userproximity event
Introductory article: Proximity API

Tag:
bug 738131 done Still needs some review here and there but it shouldn't be really troublesome.

Spec: http://www.w3.org/TR/proximity/ (the draft is more accurate)
Screen Orientation Screen.orientation
Screen.lockOrientation()
Screen.unlockOrientation()
Screen.onorientationchange
orientationchange event
Introductory article: Managing screen orientation

Tag:
bug 720794
bug 740188
bug 673922
done Spec: http://www.w3.org/TR/screen-orientation/
MXR: Screen
WikiMo: ScreenOrientation
Simple Push Notification API window.navigator.push
PushManager
Introductory article: Simple Push API

Tag:
bug 831816
bug 822712
---
See also :
bug 747907
bug 763198
done Simpler push API for B2G.

It seams it completely replace the original Push API (see bug 776501)

Spec: https://dvcs.w3.org/hg/push/raw-file/default/index.html
WikiMo: SimplePush
URL API URL
URL()
URL.createObjectURL()
URL.revokeObjectURL()
URLUtils
URLUtils.protocol
URLUtils.host
URLUtils.hostname
URLUtils.port
URLUtils.pathname
URLUtils.search
URLUtils.hash
URLUtils.username
URLUtils.password
URLUtils.origin
URLUtils.toString()
URLUtilsReadOnly
URLUtilsReadOnly.protocol
URLUtilsReadOnly.host
URLUtilsReadOnly.hostname
URLUtilsReadOnly.port
URLUtilsReadOnly.pathname
URLUtilsReadOnly.search
URLUtilsReadOnly.hash
URLUtilsReadOnly.toString()
Location (adaptation)
WorkerLocation (adaptation)
HTMLAnchorElement (adaptation)
HTMLAreaElement (adaptation)
URLQuery <--- not yet landed!!
Introductory article: none, pretty obvious

Tag:
bug 813253
bug 887364
bug 828261
bug 839912
bug 887836 (URLQuery)
done Spec: http://url.spec.whatwg.org/
Vibration API Navigator.vibrate()
Introductory article: Vibration

Tag:
bug 679966 done Spec: http://www.w3.org/TR/vibration/
Web activities MozActivity
MozActivityOptions
MozActivityRequestHandler
window.navigator.mozSetMessageHandler()
window.navigator.mozHasPendingMessage()
Introductory article: Web Activities

Tag:

Postponed API:
MozActivityHandlerDescription
window.navigator.mozRegisterActivityHandler()
window.navigator.mozUnregisterActivityHandler()
window.navigator.mozIsActivityHandlerRegistered()
bug 715814, bug 776027 for Android

Si also bug 755245
done Technical review performed by Mounir Lamouri
Needs editorial review

Discuss the API with Vivien.

MXR: Activity, ActivityOptions, ActivityHandlerDescription, ActivityRequestHandler, NavigatorActivities, NavigatorSystemMessages
WikiMo: WebActivities

Started some app pair. It doesn't work (on FirefoxOS simulator), don't know why exactly. Asked for some help. Not conclusive yet
WebFM API navigator.mozFMRadio
FMRadio
Introductory article: WebFM API

Tag:
bug 749053
bug 779500
done The events name still need to be documented but as they have nothing special it's not a high priority.

MXR: FMRadio
WebPayment navigator.mozPay()
Introductary article: In-app payment

Tag:
bug 767818 done Maybe we could write something on How to sign a JWT server side.

WikiMo: WebPayment

Privileged APIs

API Name Entry Points Bugs Doc status Notes
Browser API Introductory article: Using the Browser API

Extentions to iframe:
HTMLIFrameElement.reload
HTMLIFrameElement.stop
HTMLIFrameElement.getCanGoBack
HTMLIFrameElement.goBack
HTMLIFrameElement.getCanGoForward
HTMLIFrameElement.goForward
HTMLIFrameElement.setVisible
HTMLIFrameElement.getVisible
HTMLIFrameElement.purgeHistory
HTMLIFrameElement.sendMouseEvent
HTMLIFrameElement.sendTouchEvent
HTMLIFrameElement.addNextPaintListener
HTMLIFrameElement.removeNextPaintListener
HTMLIFrameElement.getScreenshot

Events
mozbrowserasyncscroll
mozbrowserclose
mozbrowsercontextmenu
mozbrowsererror
mozbrowsericonchange
mozbrowserloadend
mozbrowserloadstart
mozbrowserlocationchange
mozbrowseropenwindow
mozbrowsersecuritychange
mozbrowsershowmodalprompt
mozbrowsertitlechange
mozbrowserusernameandpasswordrequired

Tag:
bug 693515 Done Still need editorial and technical reviews

WikiMo: BrowserAPI
Contacts API window.navigator.mozContacts
mozContact
ContactManager
MozContactChangeEvent
Introductory article: Contacts API

Tag:
bug 674720 done

Needs a quick technical review

Spec: http://www.w3.org/TR/contacts-manager-api/
MXR: ContactManager, ContactProperties, ContactChangeEvent
WikiMo: ContactsAPI

Also see the intern presentation on Mozilla Air.

Device Storage API navigator.getDeviceStorages()
navigator.getDeviceStorage()
DeviceStorage
DeviceStorageChangeEvent
Introductory article: Device Storage

Tag:
bug 717103 Done getDeviceStorages needs some investigation but it doesn't look urgente.

Technical review asked to Doug Turner.

MXR: DeviceStorage
WikiMo: DeviceStorageAPI
TCP Socket API navigator.mozTCPSocket
TCPSocket
TCPServerSocket
Introductory article: TCP Socket API

Tag:
(FxOS 1.0)
bug 733573
------------
(FxOS 1.2)
bug 797561
bug 784816
done Still needs review.

MXR: TCPSocket

Certified APIs

API Name Entry Points Bugs Doc status Notes
Camera API navigator.mozCameras
CameraManager
CameraControl
CameraCapabilities

Tag:
  done Tech review perform by Mike Habicher

Properties need an editorial review

Maybe needs an introductory article.

ML: Discussion thread
MXR: CameraManager
Idle API navigator.addIdleObserver
navigator.removeIdleObserver
Introductory article: Idle API

Tag:
bug 715041 done Needs editorial review.

Spec: Not yet (part of sysapps)
WikiMo: IdleAPI
Network Stats API navigator.mozNetworkStats
MozNetworkStats
MozNetworkStatsData
MozNetworkStatsManager
Introductory article: Network stats

Tag:
bug 746069 done MXR: NetworkStatsNetworkStatsManager
Permissions API navigator.mozPermissionSettings
PermissionSettings
Introductory article: Permissions API
 
bug 707625
bug 770731
done MXR: PermissionSettings
Power Management API navigator.mozPower
PowerManager
navigator.requestWakeLock
Introductory article: Power Management

Tag:
bug 708964 done Tech review perform by Justin Lebar.

Needs an editorial review

MXR: PowerManager
WikiMo: PowerManagementAPI
Settings API navigator.mozSettings
SettingsManager
SettingsLock
MozSettingsEvent
Introductory article: Settings API

Tag:
bug 678695 done Tech review perform by Gregor Wagner

Needs editorial review

MXR: SettingsManager
WikiMo: SettingsAPI
Time/Clock API navigator.mozTime
MozTimeManager
window.onmoztimechange
moztimechange event
Introductory article: Time and Clock

Tag:
bug 714357, bug 714358 (notification upon time change) done The moztimechange event still need to be documented but as it has nothing special it's not a high priority.

MXR: TimeManager
WebBluetooth window.navigator.mozBluetooth
BluetoothManager
BluetoothAdapter
BluetoothDevice
BluetoothDeviceEvent
BluetoothStatusChangedEvent
Introductory article: WebBluetooth

Tag:
bug 674737 Done Technical review ask to Eric Chou

The introductory article only conver pairing, therefor it serously need to be improved. However, the API should be rework for Firefox 1.4 so maybe it is wise to delay until that.

MXR: bluetooth
WikiMo: WebBluetooth
WebSMS navigator.mozMobileMessage
MozSmsMessage
MozSmsEvent
MozSmsFilter
MozSmsSegmentInfo
MozMobileMessageManager
MozMmsMessage
MozMmsEvent
MozMobileMessageThread
Introductory article: WebSMS

Deprecated:
navigator.mozSms
MozSmsManager

Tag:
bug 674725
---
bug 903403
Done Spec: Messaging API (Editor's draft)
WikiMo: WebSMS
WebTelephony navigator.mozTelephony
Telephony
TelephonyCall
CallEvent
Introductory article: WebTelephony, introduction to WebTelephony and Using the Telephony API

Tag:
bug 674726 done The Introduction to WebTelephony and Using the Telephony API articles need to be seriously reworked.

WikiMo: WebTelephony
WiFi Information API navigator.mozWifiManager
WifiManager
MozWifiConnectionInfoEvent
MozWifiStatusChangeEvent
Introductory article: Wifi Information API

Tag: ?
bug 717123
bug 864932
done MXR: dom/wifi

Discontinued APIs

API Name Entry Points Bugs Doc status Notes
Archive API   bug 772434 none Discuss the API with Mounir Lamouri: this API is not active by default in any build and there is discussion to figure if it must be kept or not.

MXR: ArchiveReader, ArchiveRequest, Tests
WikiMo: ArchiveAPI

Document status overview

Section Pages No tags Needs* tags Editorial reviews Technical reviews Outdated pages Dev-doc-needed bugs Documentation requests
API: CSSOM 119 n/a 57 (48%) 10 (9%) 13 (11%) 37 (32%) 6 (6%) 5 (5%)
API: Canvas 127 n/a 0 (0%) 0 (0%) 2 (2%) 67 (53%) 2 (2%) 0 (0%)
API: DOM 628 n/a 117 (19%) 14 (3%) 90 (15%) 194 (31%) 213 (34%) 40 (7%)
API: Device API 79 n/a 36 (46%) 1 (2%) 2 (3%) 14 (18%) 64 (82%) 3 (4%)
API: File API 33 n/a 3 (10%) 2 (7%) 2 (7%) 13 (40%) n/a 0 (0%)
API: Firefox OS APIs 65 n/a 5 (8%) 1 (2%) 1 (2%) 28 (44%) n/a n/a
API: HTML API 374 n/a 158 (43%) 5 (2%) 54 (15%) 164 (44%) 71 (19%) 8 (3%)
API: IndexedDB 104 n/a 2 (2%) 0 (0%) 3 (3%) 5 (5%) 3 (3%) 5 (5%)
API: SVG API 100 n/a 94 (94%) 5 (5%) 9 (9%) 18 (18%) n/a 4 (4%)
API: ServiceWorkers 117 n/a 7 (6%) 2 (2%) 52 (45%) 1 (1%) 0 (0%) n/a
API: Web Animations 39 n/a 0 (0%) 0 (0%) 0 (0%) 0 (0%) 10 (26%) 0 (0%)
API: WebAudio 206 n/a 5 (3%) 16 (8%) 64 (32%) 10 (5%) 2 (1%) 4 (2%)
API: WebComponents 6 n/a 0 (0%) 0 (0%) 3 (50%) 3 (50%) n/a n/a
API: WebCrypto 20 n/a 0 (0%) 0 (0%) 1 (5%) 11 (56%) n/a n/a
API: WebGL 273 n/a 0 (0%) 0 (0%) 0 (0%) 8 (3%) 9 (4%) n/a
API: WebRTC 191 n/a 9 (5%) 2 (2%) 21 (11%) 12 (7%) 20 (11%) 35 (19%)
API: WebSockets 7 n/a 3 (43%) 0 (0%) 3 (43%) 1 (15%) 8 (115%) 2 (29%)
API: WebSpeech 88 n/a 0 (0%) 0 (0%) 0 (0%) 0 (0%) n/a n/a
API: WebStorage 10 n/a 0 (0%) 0 (0%) 1 (10%) 6 (60%) n/a n/a
API: WebVR 77 n/a 0 (0%) 0 (0%) 1 (2%) 0 (0%) n/a n/a
API: WebWorkers 38 n/a 1 (3%) 0 (0%) 5 (14%) 15 (40%) 4 (11%) 5 (14%)
Total 2701 0 497 58 327 607 412 111

See also

Document Tags and Contributors

 Contributors to this page: fscholz, jswisher, Sheppy, teoli
 Last updated by: fscholz,