Firefox Tomorrow

http header

RTT header

View on MDN ↗

Limited availability

The HTTP RTT request header is a network client hint which provides the approximate round trip time on the application layer, in milliseconds. The RTT hint includes server processing time, unlike transport layer RTT.

The RTT value is rounded to the nearest 25 milliseconds to prevent fingerprinting, although there are many other mechanisms an attacker might use to obtain similar round-trip information.

The hint allows a server to choose what information is sent based on the network responsiveness/latency. For example, it might choose to send fewer resources.

[!NOTE] The Vary header is used in responses to indicate that a different resource is sent for every different value of the header (see HTTP Caching Vary). Even if RTT is used to configure what resources are sent consider omitting it in the Vary header — it is likely to change often, which effectively makes the resource uncacheable.

Header type [Request header](https://developer.mozilla.org/en-US/docs/Glossary/Request%20header), Client hint
[Forbidden request header](https://developer.mozilla.org/en-US/docs/Glossary/Forbidden%20request%20header) No

Syntax

RTT: <number>

Directives

  • <number>
    • : The approximate round trip time in milliseconds, rounded to the nearest 25 milliseconds.

Examples

Using RTT client hints

A server first needs to opt in to receive the RTT header by sending the Accept-CH response header containing RTT.

Accept-CH: RTT

Then on subsequent requests the client might send an RTT header back:

RTT: 125

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also