Ambient light sensorLimited availability
The AmbientLightSensor API returns the current light level in lux of the ambient light level around the device.
Not yet supported in all major browsers — check the table and provide a fallback.
Browser support
DesktopChrome
✕Not supportedup to 155
Current: 155Edge
✕Not supportedup to 154
Current: 154Firefox
✕Not supportedup to 157
Current: 157Safari
✕Not supportedup to 27
Current: 27MobileChrome Android
✕Not supportedup to 155
Current: 155Firefox Android
✕Not supportedup to 157
Current: 157Safari iOS
✕Not supportedup to 27
Current: 27How to use
Not supported in Chrome, Edge, Firefox, Safari, Chrome Android, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.
Example
Full syntax and examples are on MDN: AmbientLightSensor.
Feature detection
JS · check before using
if ("AmbientLightSensor" in globalThis) {
// AmbientLightSensor is available
} else {
// load a polyfill or use a fallback
}Documentation (MDN)
Specification
Usage share
Sub-features
Support for each part of the feature (6). The overall table above shows when the whole feature works.
| Sub-feature | Chrome | Edge | Firefox | Safari | Chrome Android | Firefox Android | Safari iOS |
|---|---|---|---|---|---|---|---|
| AmbientLightSensor | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| AmbientLightSensor.AmbientLightSensor | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| AmbientLightSensor.illuminance | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| Permissions.permission_ambient-light-sensor | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| iframe.allow.ambient-light-sensor | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| http.headers.Permissions-Policy.ambient-light-sensor | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |