The Trailer request header allows the sender to include additional fields at the end of chunked messages in order to supply metadata that might be dynamically generated while the message body is sent, such as a message integrity check, digital signature, or post-processing status.
The TE
request header needs to be set to "trailers" to allow trailer fields.
Header type | Response header |
---|---|
Forbidden header name | yes |
Syntax
Trailer: header-names
Directives
header-names
- HTTP header fields which will be present in the trailer part of chunked messages. These header fields are disallowed:
- message framing headers (e.g.,
Transfer-Encoding
andContent-Length
), - routing headers (e.g.,
Host
), - request modifiers (e.g., controls and conditionals, like
Cache-Control
,Max-Forwards
, orTE
), - authentication headers (e.g.,
Authorization
orSet-Cookie
), - or
Content-Encoding
,Content-Type
,Content-Range
, andTrailer
itself.
- message framing headers (e.g.,
Examples
Chunked transfer encoding using a trailing header
In this example, the Expires
header is used at the end of the chunked message and serves as a trailing header.
HTTP/1.1 200 OK Content-Type: text/plain Transfer-Encoding: chunked Trailer: Expires 7\r\n Mozilla\r\n 9\r\n Developer\r\n 7\r\n Network\r\n 0\r\n \r\n Expires: Wed, 21 Oct 2015 07:28:00 GMT
Specifications
Specification | Title |
---|---|
RFC 7230, section 4.4: Trailer | Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing |
RFC 7230, section 4.1.2: Chunked trailer part | Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Servo |
---|---|---|---|---|---|---|---|
Trailer | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge Mobile | Firefox for Android | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Trailer | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |