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 privileged or certified applications only.


The focusMode property value is a string that defines which kind of focus mode the camera should use. When set, its new value must be chosen from the list of options specified by  CameraCapabilities.focusModes.


var focus = instanceOfCameraControl.focusMode


Return a string representing the current focus mode. The default value is auto or fixed (this depends on the device).


var options = {
  camera: navigator.mozCameras.getListOfCameras()[0]
function onSuccess( camera ) {
  var capabilities = camera.capabilities;

  if (capablities.focusModes.indexOf('macro') > -1) {
    camera.focusMode = 'macro';

navigator.mozCameras.getCamera(options, onSuccess)


Not part of any specification; however, this API should be removed when the WebRTC Capture and Stream API has been implemented.

See also

Document Tags and Contributors

Last updated by: chrisdavidmills,