Trailer
Der HTTP Trailer Anforderungs- und Antwortheader erlaubt es dem Absender, zusätzliche Felder am Ende von chunked Nachrichten hinzuzufügen, um Metadaten bereitzustellen, die möglicherweise während des Sendens des Nachrichtenkörpers dynamisch erzeugt werden.
Hinweis:
Der TE
Anforderungsheader muss auf trailers
gesetzt sein, um Trailer-Felder zu ermöglichen.
Warnung:
Entwickler können nicht über die Fetch API oder XHR auf HTTP-Trailer zugreifen.
Außerdem ignorieren Browser HTTP-Trailer, mit Ausnahme des Server-Timing
Headers.
Weitere Informationen finden Sie unter Browser-Kompatibilität.
Header-Typ | Anforderungsheader, Antwortheader, Inhaltsheader |
---|---|
Verbotener Header-Name | Ja |
Syntax
Trailer: header-names
Direktiven
header-names
-
HTTP-Headerfelder, die im Trailer-Teil von chunked Nachrichten vorhanden sein werden. Die folgenden Header-Namen sind nicht erlaubt:
Content-Encoding
,Content-Type
,Content-Range
undTrailer
- Authentifizierungsheader (z. B.
Authorization
oderSet-Cookie
) - Nachrichtenrahmen-Header (z. B.
Transfer-Encoding
undContent-Length
) - Routing-Header (z. B.
Host
) - Anforderungsmodifikatoren (z. B. Steuerungen und Bedingungen wie
Cache-Control
,Max-Forwards
oderTE
)
Beispiele
Server-Timing als HTTP-Trailer
Einige Browser unterstützen die Anzeige von Server-Timing-Daten in den Entwicklertools, wenn der Server-Timing
Header als Trailer gesendet wird.
Im folgenden Antwortbeispiel wird der Trailer
Header verwendet, um anzuzeigen, dass ein Server-Timing
Header dem Antwortkörper folgen wird.
Eine Metrik custom-metric
mit einer Dauer von 123.4
Millisekunden wird gesendet:
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Trailer: Server-Timing
--- response body ---
Server-Timing: custom-metric;dur=123.4
Spezifikationen
Specification |
---|
HTTP Semantics # field.trailer |
HTTP/1.1 # chunked.trailer.section |
Browser-Kompatibilität
BCD tables only load in the browser