Skip to Content
Platform.Ontology

Display refresh rate measurement

Counts animation frames per second to find the monitor's refresh rate.

Gets silentlySpeed and timingDeviceWeb browsersWhile you use it

In one line

Can count frames to find your screen's refresh rate

Counts animation frames per second to find the monitor's refresh rate.

requestAnimationFrame timing reveals 60, 90, 120, 144 or 165 Hz displays, and variable refresh. Combined with devicePixelRatio and screen size it narrows the device model (e.g. ProMotion iPads and iPhones at 120 Hz).

What it can and can't do

What the user does: Nothing. It happens when the page loads, or when animations run

It can

  • Learn if your screen runs at 60, 90, 120, 144 or 165 Hz
  • Spot variable refresh screens
  • Combine it with screen size to narrow your device model

It cannot

  • Know the exact screen model
  • Ask permission first
  • See your files
  • Know who you are by itself

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported242013-01-10None
EdgeSupported122015-07-29None
FirefoxSupported232013-08-06None
SafariSupported72013-10-22None
Safari on iPhoneSupported72013-09-18None
Chrome on AndroidSupported252013-02-27None
Samsung InternetSupported1.52013-09-25None

How a site asks for it

APIrequestAnimationFrame deltas; matchMedia('(update: fast)')
Browser compat keysapi.Window.requestAnimationFrame
How access is grantednone
What the user seesNot listed
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsNot listed
How to take it backNot listed
Inside an iframeNot listed

Typical flow

  1. Run rAF for 500 ms
  2. Compute mean frame delta
  3. Round to a common refresh rate

Data you get

What comes back: Hz, about 1 Hz accuracy
Shape: float

FieldTypeUnitRangePrecision
frame intervalfloatms4 to 33timer limited; rounded to 1 Hz bins

Technical limits

  • Background tabs run rAF at 0
  • Battery saver caps to 30 or 60 Hz
  • Safari 17 and Firefox clamp rAF to timer resolution

The story

What it is

A script counts animation frames per second to find out if your screen runs at 60, 120 or more Hz.

For you

You never see it. A game or animation tests how fast your screen updates, and then runs smoothly at that speed. A fast gaming screen gets smoother motion.

For makers

Games and animation apps need the refresh rate to avoid stutter and to match speed to the screen. The same number is a clue about your hardware, which helps fraud and tracking tools.

Where you see it

TypeExampleApps
gamesA browser game finds that your screen is 144 Hz and runs its motion at that rate for a smoother feel.Krunker.io, Shell Shockers
gamesA cloud gaming page matches the stream frame rate to your display so there is no judder.Xbox Cloud Gaming, GeForce NOW
videoA video player matches playback to the screen to avoid uneven motion in fast scenes.YouTube
creativeA web animation tool shows a smooth preview at the exact refresh rate of your display.Figma
securityA fraud tool sees that a device claims to be a phone but shows a refresh rate only found on a desktop monitor.None named
adsA tracker adds refresh rate to a device ID, as it differs by screen.None named
accessibilityA page lowers animation speed when the screen is slow, to prevent motion that makes some people dizzy.None named

Risks

  • Reveals your screen
  • Adds to a device ID

What the platform says

Good uses and abuse

Legitimate uses

  • Animation pacing

Known abuse

  • Device class (120 Hz is iPhone Pro, iPad Pro, flagship Android)

Scores

ScoreValueMeaning
Sensitivity2 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 bits3Rough identifying entropy, when known

Sources

How well checked: Based on official documentation.

On this page