Screen brightness
A site cannot read how bright your screen is set.
In one line
Can't see how bright your screen is set
A site cannot read how bright your screen is set.
No API exposes backlight level. Proxies: prefers-color-scheme, dynamic-range and Screen Wake Lock state. Ambient light sensor was removed from stable browsers (Chrome behind a flag, Firefox 122 removed it) for fingerprint and privacy risk.
What it can and can't do
What the user does: Nothing. Pages have no way to ask for this
It can
- See if you use light or dark mode
- Check HDR and color range support
- Keep your screen awake with a wake lock
- Use a light sensor only where a flag turns it on in Chrome
It cannot
- See the brightness level
- See your battery saver or night mode
- Use the ambient light sensor in Firefox, which removed it
- Change your brightness
Browser support
| Browser | Status | First version | Note |
|---|---|---|---|
| Chrome | Not supported | Not available | None |
| Edge | Not supported | Not available | None |
| Firefox | Not supported | Not available | None |
| Safari | Not supported | Not available | None |
| Safari on iPhone | Not supported | Not available | None |
| Chrome on Android | Not supported | Not available | None |
| Samsung Internet | Not supported | Not available | None |
How a site asks for it
| API | none |
| How access is granted | not-exposed |
| What the user sees | None |
| Needs a secure context (HTTPS) | No |
| Needs a user gesture | No |
| How long it lasts | read fresh on every page load; nothing stored |
| How to take it back | not applicable |
| Inside an iframe | Readable from cross-origin iframes too (same values) |
Typical flow
- Page script reads the value
- No prompt is shown
Data you get
Shape: none
How often: static per session
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
proxy: prefers-color-scheme | string | None | light or dark theme only | Not listed |
proxy: Screen Wake Lock | string | None | request only, no readout | Not listed |
Technical limits
- Side-channel risk led to removal
The story
What it is
A site cannot read how bright your screen is set.
For you
A site cannot see or change your screen brightness. It can only see whether you prefer a dark or light theme, and it can ask to keep the screen awake.
For makers
Brightness is a private device setting and a possible fingerprint. The web exposes only your theme preference and wake lock. Apps work around it with themes.
Where you see it
| Type | Example | Apps |
|---|---|---|
| video | A video site wanted brightness to adjust the picture and uses dark or light theme instead. | YouTube |
| fitness | A workout page keeps the screen awake during a class using wake lock. | None named |
| accessibility | A reading site wanted brightness to adapt contrast and relies on your theme and contrast settings. | None named |
| games | A browser game wanted brightness for a night mode and follows the system theme. | None named |
| maps | A map in navigation mode keeps the screen on, and cannot change brightness. | Google Maps |
| ads | An advertiser wanted brightness as a time of day clue and cannot get it. | None named |
| security | A tracker wanted brightness as a fingerprint input and is blocked. | None named |
Risks
- Theme and wake lock still hint at habits
What the platform says
- Google: Screen Wake Lock API. Chrome describes a way for a page to keep the screen on, without any control over brightness.
Good uses and abuse
Legitimate uses
- None: the browser deliberately withholds it
Known abuse
- Sites attempt proxies to recover it
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 2 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 3 of 5 | How much the user has to do |
| Fingerprint bits | 0 | Rough identifying entropy, when known |
Related capabilities
Related
- prefers-color-scheme. Can tell whether your device theme is light or dark
Sources
How well checked: Based on official documentation.