Skip to Content
Platform.Ontology

update, scripting, monochrome

Screen refresh type, whether JS is enabled, and monochrome depth.

Gets silentlyScreen and windowsCSS media featuresWeb browsersWhen the page loadsWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported1132023-05-02None
EdgeSupported1132023-05-05None
FirefoxSupported1022022-06-28None
SafariSupported172023-09-18None
Safari on iPhoneSupported172023-09-18None
Chrome on AndroidSupported1132023-05-02None
Samsung InternetSupported23.02023-10-18None

How a site asks for it

APImatchMedia('(update: slow)'), (scripting: none), (monochrome)
Browser compat keyscss.at-rules.media.update
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsread fresh on every page load; nothing stored
How to take it backnone needed (no grant)
Inside an iframeReadable from cross-origin iframes too (same values)

Typical flow

  1. Page script reads the value
  2. No prompt is shown

Data you get

Shape: object
How often: static per session

FieldTypeUnitRangePrecision
update, scripting, monochromeenumNoneupdate: none, slow, fast; scripting: none, initial-only, enabled; monochrome: 0 to 16Not 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

TypeExampleApps
newsA reading site serves a plain layout with no animation on an e ink tablet.None named
gamesA browser game turns off fast animation if it runs on a very slow refresh screen.None named
securityA fraud check sees a browser that says scripts are off while running scripts, a sign of a masked or automated tool.None named
shoppingA store gives a clean black and white print page for receipts and coupons.None named
educationA learning site makes a printable worksheet in grayscale.None named
analyticsA 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

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits0.5Rough identifying entropy, when known

Sources

How well checked: Based on official documentation.

On this page