Skip to Content
Platform.Ontology

Network Information API

Estimated connection type, speed and latency, plus a data-saver flag.

Gets silentlyNetwork and connectionConnection qualityWeb browsersWhen the page loadsWhile you use it

In one line

Can see roughly how fast your connection is and whether you turned on data saving

Estimated connection type, speed and latency, plus a data-saver flag.

Lets a site pick light pages on slow links. effectiveType buckets: slow-2g, 2g, 3g, 4g. downlink rounds to 25 kbps steps (capped near 10 Mbps), rtt to 25 ms steps. Type (wifi or cellular) is Android only.

What it can and can't do

What the user does: Nothing. It happens when the page loads and while you stay on it

It can

  • See a rough speed class such as 2G, 3G or 4G
  • See rounded speed and delay figures
  • See if data saver is on
  • Tell Wi-Fi from cellular on Android only

It cannot

  • See your exact speed, since figures are rounded to coarse steps
  • Work in Firefox or Safari
  • Tell Wi-Fi from cellular on a computer
  • See your provider, name or location

How it differs between platforms: Only Chrome, Edge and Samsung Internet offer it. Wi-Fi versus cellular is shown on Android only.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported612017-09-05type since 38 on Android
EdgeSupported792020-01-15None
FirefoxNot supportedNot availableNot listedAndroid only, removed
SafariNot supportedNot availableNot listedDeclined
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported382014-10-08None
Samsung InternetSupported3.02015-04-10None

How a site asks for it

APInavigator.connection.effectiveType, .downlink, .rtt, .saveData, .type, 'change' event
Browser compat keysapi.NetworkInformation.effectiveType
api.NetworkInformation.downlink
api.NetworkInformation.rtt
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
effectiveTypeenumNoneslow-2g, 2g, 3g, 4gfrom rtt and downlink thresholds
downlinkfloatMbps0 to 10rounded to 25 kbps
rttintegerms0 to about 3000rounded to 25 ms
saveDatabooleanNonetrue or falseNot listed
typeenumNonebluetooth, cellular, ethernet, wifi, wimax, none, other, unknownAndroid Chromium

Technical limits

  • Chromium only
  • Estimate from recent traffic, not a speed test
  • Cannot read Wi-Fi name or signal

The story

What it is

A page can read your estimated connection type, speed and delay, and if data saver is on.

For you

You never see a prompt. Sites may load lighter pictures or skip auto video if your line is slow or you turned on data saver. You just see a faster page.

For makers

Makers use it to cut load time, save mobile data and keep users from leaving. It is also quietly counted in some fingerprints. Firefox and Safari do not offer it.

Where you see it

TypeExampleApps
videoA video site starts at 480p on a weak connection and moves up when speed improves.YouTube
gamesA browser game checks speed before loading its big level pack and offers a smaller pack on slow lines.None named
shoppingA store shows tiny image placeholders first for shoppers with data saver on.None named
newsA news site holds back auto play video on slow connections and metered data plans.None named
productivityA web editor such as Google Docs delays syncing big attachments until the connection is better.Google Docs
analyticsA speed dashboard shows how page load changes by connection type across real visitors.None named
adsAn ad script reads type, speed and delay as part of a device fingerprint.None named

Risks

  • Adds to a fingerprint
  • Chromium only

What the platform says

Good uses and abuse

Legitimate uses

  • Adaptive loading
  • Lite pages

Known abuse

  • Network-class fingerprint
  • Price discrimination by connection

Scores

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

A real example: LinkedIn

Connection type, downlink, RTT collected. Read by the LinkedIn APFC fingerprint script (alleged by BrowserGate, partly confirmed by BleepingComputer).

History

  • 2017-09, Chrome 61: effectiveType, rtt, downlink available
  • 2019-01, Firefox: Not supported on desktop; Android support removed

Sources

How well checked: Checked against real behavior.

On this page