Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The AmbientLightSensor() constructor creates a new AmbientLightSensor object, which returns the current light level or illuminance of the ambient light 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. The Feature-Policy HTTP header article contains implementation instructions.


new AmbientLightSensor()
new AmbientLightSensor(options)


options Optional

Currently only one option is supported:


The desired number of times per second a sample should be taken, meaning the number of times per second that reading event will be called. A whole number or decimal may be used, the latter for frequencies less than a second. The actual reading frequency depends on the device hardware and consequently may be less than requested.


Ambient Light Sensor
# dom-ambientlightsensor-ambientlightsensor

Browser compatibility

BCD tables only load in the browser

See also