Skip to Content
Platform.Ontology

Network client hints (ECT, RTT, Downlink)

Server-side headers with the effective connection type, RTT and downlink.

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

In one line

Can see your rough connection speed and delay in each request, if it asks first

Server-side headers with the effective connection type, RTT and downlink.

Same numbers as the Network Information API but delivered on requests so the server can adapt before sending HTML. Requires Accept-CH opt-in, with the same 25 ms and 25 kbps rounding.

What it can and can't do

What the user does: Nothing. It happens after the site opts in, on each page load

It can

  • Receive speed and delay hints with your request
  • Send a lighter page if your connection is slow
  • Notice when your connection class changes between visits

It cannot

  • Get exact speed, since figures are rounded to coarse steps
  • Work in Firefox or Safari
  • Get anything unless the site opts in first
  • See your name or location

How it differs between platforms: Chrome, Edge and Samsung Internet send it. Firefox and Safari do not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported672018-05-29None
EdgeSupported792020-01-15None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported672018-05-31None
Samsung InternetSupported9.02018-09-15None

How a site asks for it

APIAccept-CH: ECT, RTT, Downlink; request headers ECT, RTT, Downlink
Browser compat keyshttp.headers.ECT
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
ECTenumNoneslow-2g, 2g, 3g, 4gNot listed
RTTintegermsmultiples of 25Not listed
DownlinkfloatMbpsto 25 kbps stepsNot listed

Technical limits

  • Chromium only
  • Needs Accept-CH

The story

What it is

Servers can receive a note about your connection type, delay and speed with each request.

For you

You never see it. If a site asks, your browser tells its server how good the connection seems. The server may send a smaller page if the line is slow.

For makers

Makers can decide what to send before the browser runs any script. That saves time for slow users. The details also add a small clue to a device fingerprint.

Where you see it

TypeExampleApps
videoA video platform reads the hint on the first request and picks a lower starting quality for slow connections.YouTube
shoppingA store sends a short list of products with small pictures on slow lines, and the full page on fast ones.None named
newsA news site serves a text first version on slow connections, and loads pictures later.None named
gamesA browser game site serves a smaller loader and delays heavy assets for players on slow lines.None named
adsAn ad server picks a lightweight ad for slow connections so the page is not blocked.None named
analyticsA speed monitoring tool groups real page load times by connection type from the headers.None named
accessibilityA government site gives a plain, light page to people on slow rural internet, so forms still work.None named

Risks

  • Adds to a fingerprint
  • Chromium only

What the platform says

  • MDN Web Docs: ECT header. Tells the server the browser's effective connection type, so it can pick lighter or richer content.

Good uses and abuse

Legitimate uses

  • Server-side adaptation

Known abuse

  • Connection fingerprint

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 bits2Rough identifying entropy, when known

History

  • 2019-01, Chrome 67: Shipped

Sources

How well checked: Based on official documentation.

On this page