Trailer header
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Der HTTP Trailer Anfrage und Antwort-Header erlaubt es dem Sender, zusätzliche Felder am Ende von gechunkten Nachrichten hinzuzufügen, um Metadaten bereitzustellen, die möglicherweise während des Sendens des Nachrichtenkörpers dynamisch generiert werden.
Hinweis:
Der TE
Anforderungs-Header muss auf trailers
gesetzt werden, um Trailer-Felder zuzulassen.
Warnung:
Entwickler können nicht auf HTTP-Trailer über die Fetch-API oder XHR zugreifen.
Zusätzlich ignorieren Browser HTTP-Trailer, mit Ausnahme von Server-Timing
.
Weitere Informationen finden Sie unter Browser-Kompatibilität.
Header-Typ | Anfrage-Header, Antwort-Header, Inhalts-Header |
---|---|
Verbotener Anfrage-Header | Ja |
Syntax
Trailer: header-names
Richtlinien
header-names
-
HTTP Header-Felder, die im Trailer-Teil von gechunkten Nachrichten vorhanden sein werden. Die folgenden Header-Namen sind unzulässig:
Content-Encoding
,Content-Type
,Content-Range
, undTrailer
- Authentifizierungs-Header (z. B.
Authorization
oderSet-Cookie
) - Nachrichten-Framing-Header (z. B.
Transfer-Encoding
undContent-Length
) - Routing-Header (z. B.
Host
) - Anfragemodifikatoren (z. B. Steuerungen und Bedingungen, wie
Cache-Control
,Max-Forwards
, oderTE
)
Beispiele
Server-Timing als HTTP-Trailer
Einige Browser unterstützen das Anzeigen von Server-Timing-Daten in den Entwickler-Tools, wenn der Server-Timing
Header als Trailer gesendet wird.
Im folgenden Antwort wird der Trailer
Header verwendet, um anzuzeigen, dass ein Server-Timing
Header dem Nachrichtenkörper folgen wird.
Ein 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 |