W3cubDocs

/DOM

AmbientLightSensor

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The AmbientLightSensor interface of the the Ambient Light Sensor API returns an interface for accessing AmbientLightSensorReading.

Constructor

AmbientLightSensor.AmbientLightSensor()
Creates a new AmbientLightSensor object.

Properties

AmbientLightSensor.reading
Returns an AmbientLightSensorReading interface, containing the current light level.

Examples

if ( 'AmbientLightSensor' in window ) {
  var sensor = new AmbientLightSensor();
  sensor.onreading = function() {
    console.log('Current light level:', sensor.illuminance);
  };
  sensor.onerror = function(event) {
    console.log(event.error.name, event.error.message);
  };
  sensor.start();
}
Specification Status Comment
Ambient Light Sensor
The definition of 'AmbientLightSensor' in that specification.
Editor's Draft Initial definition.

Browser Compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 54.0 ? ? ? ?
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support 54.0 ? ? ? ? ? 54.0

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AmbientLightSensor