The AmbientLightSensor
interface of the the Sensor APIs returns the current light level or illuminance of the ambient light around the hosting device.
To use this sensor, the user must grant permission to the 'ambient-light-sensor'
device sensor through the Permissions
API.
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 instructions.
AmbientLightSensor.AmbientLightSensor()
AmbientLightSensor
object.AmbientLightSensor.illuminance
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(); }
Specification | Status | Comment |
---|---|---|
Generic Sensor API | Candidate Recommendation | Defines sensors in general. |
Ambient Light Sensor The definition of 'AmbientLightSensor' in that specification. | Candidate Recommendation |
Desktop | ||||||
---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | |
Basic support | 54
|
? | ? | ? | 56 | ? |
AmbientLightSensor() constructor |
54
|
? | ? | ? | 56 | ? |
illuminance |
54
|
? | ? | ? | 56 | ? |
Mobile | |||||||
---|---|---|---|---|---|---|---|
Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
Basic support | 54
|
54
|
? | ? | 56 | ? | ? |
AmbientLightSensor() constructor |
54
|
54
|
? | ? | 56 | ? | ? |
illuminance |
54
|
54
|
? | ? | 56 | ? | ? |
© 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