AmbientLightSensor.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. See Feature-Policy for 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