The illuminance
property of the AmbientLightSensor
interface returns the current light level in lux of the ambient light level around the hosting device.
If a feature policy blocks use of a feature it is because your code is inconsistent with the policies set on your server. This is not something that would ever be shown to a user. See Feature-Policy
for implementation insfructions.
Syntax
var level = AmbientLightSensor.illuminance
Value
A Number
indicating the current light level in lux.
Example
if ( 'AmbientLightSensor' in window ) { const sensor = new AmbientLightSensor(); sensor.onreading = () => { console.log('Current light level:', sensor.illuminance); }; sensor.onerror = (event) => { console.log(event.error.name, event.error.message); }; sensor.start(); }
Specifications
Specification | Status | Comment |
---|---|---|
Generic Sensor API | Candidate Recommendation | Defines sensors in general. |
Ambient Light Sensor The definition of 'illuminance' in that specification. |
Candidate Recommendation |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
illuminance | Chrome
Full support
54
| Edge Full support ≤79 | Firefox No support No | IE No support No | Opera Full support 56 | Safari No support No | WebView Android
Full support
54
| Chrome Android
Full support
54
| Firefox Android No support No | Opera Android Full support 48 | Safari iOS No support No | Samsung Internet Android
Full support
6.0
|
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.