Web/API/AmbientLightSensor/AmbientLightSensor

This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.

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 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	Status	Comment
Generic Sensor API	Candidate Recommendation	Defines sensors in general.
Ambient Light SensorThe 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.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
AmbientLightSensor() constructor	Chrome Full support 56	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 43	Safari No support No	WebView Android No support No	Chrome Android Full support 56	Firefox Android No support No	Opera Android Full support 43	Safari iOS No support No	Samsung Internet Android No support No

Legend

Full support  

Full support

No support  

No support

AmbientLightSensor.AmbientLightSensor() by Mozilla Contributors is licensed under CC-BY-SA 2.5.