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 thatsensor.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 | Status | Comment |
---|---|---|
Generic Sensor API | Candidate Recommendation | Defines sensors in general. |
Ambient Light Sensor The definition of 'AmbientLightSensor()' in that specification. |
Candidate Recommendation |
Browser compatibility
BCD tables only load in the browser