AmbientLightSensor()

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.

Syntax

var ambientLightSensor = new AmbientLightSensor(options)

Parameters

options Optional

Currently only one option is supported:

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

Specifications

Specification
Ambient Light Sensor
# dom-ambientlightsensor-ambientlightsensor

Browser compatibility

BCD tables only load in the browser