Web/API/AmbientLightSensor/illuminance

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

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 SensorThe 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.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
illuminance	Chrome Full support 56 Notes' Full support 56 Notes' Notes' In Chrome 79, this method stopped returning floats and returned integers to avoid fingerprinting.	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 43 Notes' Full support 43 Notes' Notes' In Opera 66, this method stopped returning floats and returned integers to avoid fingerprinting.	Safari No support No	WebView Android No support No	Chrome Android Full support 56 Notes' Full support 56 Notes' Notes' In Chrome for Android 79, this method stopped returning floats and returned integers to avoid fingerprinting.	Firefox Android No support No	Opera Android Full support 43 Notes' Full support 43 Notes' Notes' In Opera for Android 57, this method stopped returning floats and returned integers to avoid fingerprinting.	Safari iOS No support No	Samsung Internet Android No support No

Legend

Full support  

Full support

No support  

No support

See implementation notes.'

See implementation notes.

AmbientLightSensor.illuminance by Mozilla Contributors is licensed under CC-BY-SA 2.5.