The AmbinentLightSensor()
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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
AmbientLightSensor() constructor | Chrome
Full support
54
| Edge Full support ≤79 | Firefox No support No | IE No support No | Opera Full support 56 | Safari No support No | WebView Android
Full support
54
| Chrome Android
Full support
54
| Firefox Android No support No | Opera Android Full support 48 | Safari iOS No support No | Samsung Internet Android
Full support
6.0
|
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.