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
AmbientLightSensorobject.
Properties
AmbientLightSensor.illuminance- Returns a
Numberindicating the current light level.
Examples
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 |
|---|---|---|
| Ambient Light Sensor The definition of 'AmbientLightSensor' in that specification. |
Working Draft | Initial definition. |
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.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 54 | ? | ? | ? | ? | ? |
AmbientLightSensor() constructor | 54 | ? | ? | ? | ? | ? |
illuminance | 54 | ? | ? | ? | ? | ? |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | 54 | 54 | ? | ? | ? | ? | ? |
AmbientLightSensor() constructor | 54 | 54 | ? | ? | ? | ? | ? |
illuminance | 54 | 54 | ? | ? | ? | ? | ? |