DeviceLightEvent

« DOM Reference

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.

The DeviceLightEvent provides web developers with information from photo sensors or similiar detectors about ambient light levels near the device. For example this may be useful to adjust the screen's brightness based on the current ambient light level in order to save energy or provide better readability.

Properties

DeviceLightEvent.value
The level of the ambient light in lux.

Example

window.addEventListener('devicelight', function(event) {
  console.log(event.value);
});

Specifications

Specification Status Comment
Ambient Light Events Candidate Recommendation Initial specification

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support Not supported 22.0 (22.0) (Mac OS X only) Not supported Not supported Not supported
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support Not supported Not supported 15.0 (15.0) Not supported Not supported Not supported

Gecko-specific notes

The devicelight event is implemented and preference enabled by default in Firefox Mobile for Android (15.0) and in Firefox OS (B2G). Starting with Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19) a desktop implementation for Mac OS X is also available. Support for Windows 7 is in progress (see bug 754199).

See also

Document Tags and Contributors

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