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 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
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
AmbientLightSensor |
56 |
79 |
No |
No |
43 |
No |
No |
56 |
No |
43 |
No |
No |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AmbientLightSensor/AmbientLightSensor