update, scripting, monochrome
Screen refresh type, whether JS is enabled, and monochrome depth.
In one line
Can tell how your screen refreshes, if scripting is on, and if it is monochrome
Screen refresh type, whether JS is enabled, and monochrome depth.
update is none for e-ink or print; scripting reports enabled or none; monochrome is 0 on color screens. Mostly identifies e-readers and print contexts.
What it can and can't do
What the user does: Nothing. It happens when the page loads.
It can
- Check whether the screen updates slowly, like an e-ink reader
- Check whether scripting is on
- Check whether the screen is monochrome
It cannot
- Name your device
- See anything else about your screen
- Change any of these settings
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 113 | 2023-05-02 | None |
| Edge | Supported | 113 | 2023-05-05 | None |
| Firefox | Supported | 102 | 2022-06-28 | None |
| Safari | Supported | 17 | 2023-09-18 | None |
| Safari on iPhone | Supported | 17 | 2023-09-18 | None |
| Chrome on Android | Supported | 113 | 2023-05-02 | None |
| Samsung Internet | Supported | 23.0 | 2023-10-18 | None |
How a site asks for it
| API | matchMedia('(update: slow)'), (scripting: none), (monochrome) |
| Browser compat keys | css.at-rules.media.update |
| How access is granted | none |
| 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 | none needed (no grant) |
| 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: object
How often: static per session
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
update, scripting, monochrome | enum | None | update: none, slow, fast; scripting: none, initial-only, enabled; monochrome: 0 to 16 | Not listed |
Technical limits
- scripting: none only visible to CSS, since JS reports enabled
The story
What it is
Reports how your screen refreshes, whether scripts run, and whether the display is black and white.
For you
You never see the reading. On a normal screen the answers are always the same. They only differ for e ink readers, printers or very basic setups.
For makers
Makers use it to serve printable or slow screen layouts. Because almost everyone gives the same answer, the values are weak for tracking, but odd answers can reveal unusual or automated browsers.
Where you see it
| Type | Example | Apps |
|---|---|---|
| news | A reading site serves a plain layout with no animation on an e ink tablet. | None named |
| games | A browser game turns off fast animation if it runs on a very slow refresh screen. | None named |
| security | A fraud check sees a browser that says scripts are off while running scripts, a sign of a masked or automated tool. | None named |
| shopping | A store gives a clean black and white print page for receipts and coupons. | None named |
| education | A learning site makes a printable worksheet in grayscale. | None named |
| analytics | A team checks how many visitors have a non standard display before dropping old support. | None named |
Risks
- Weak fingerprint clue
- Reveals unusual devices
What the platform says
- MDN: update media feature. Documents how a page can tell whether the screen refreshes quickly, slowly or never, like e ink or print.
Good uses and abuse
Legitimate uses
- Respect OS theme and accessibility needs
- Adapt layout
Known abuse
- Infer disability or setting for fingerprinting
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 0.5 | Rough identifying entropy, when known |
Related capabilities
Related
- Accessibility settings inferred. Can guess you may use accessibility settings by combining several browser signals
Sources
How well checked: Based on official documentation.