Network client hints (ECT, RTT, Downlink)
Server-side headers with the effective connection type, RTT and downlink.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 67 | 2018-05-29 | None |
| Edge | Supported | 79 | 2020-01-15 | None |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 67 | 2018-05-31 | None |
| Samsung Internet | Supported | 9.0 | 2018-09-15 | None |
How a site asks for it
| API | Accept-CH: ECT, RTT, Downlink; request headers ECT, RTT, Downlink |
| Browser compat keys | http.headers.ECT |
| 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 |
|---|---|---|---|---|
ECT | enum | None | slow-2g, 2g, 3g, 4g | Not listed |
RTT | integer | ms | multiples of 25 | Not listed |
Downlink | float | Mbps | to 25 kbps steps | Not 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
| Type | Example | Apps |
|---|---|---|
| video | A video platform reads the hint on the first request and picks a lower starting quality for slow connections. | YouTube |
| shopping | A store sends a short list of products with small pictures on slow lines, and the full page on fast ones. | None named |
| news | A news site serves a text first version on slow connections, and loads pictures later. | None named |
| games | A browser game site serves a smaller loader and delays heavy assets for players on slow lines. | None named |
| ads | An ad server picks a lightweight ad for slow connections so the page is not blocked. | None named |
| analytics | A speed monitoring tool groups real page load times by connection type from the headers. | None named |
| accessibility | A 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
| 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 | 2 | Rough identifying entropy, when known |
History
- 2019-01, Chrome 67: Shipped
Related capabilities
Related
- Network Information API. Can see roughly how fast your connection is and whether you turned on data saving
Sources
How well checked: Based on official documentation.