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-Anforderungs und Antwort-Header erlaubt es dem Absender, zusätzliche Felder am Ende von chunked Nachrichten hinzuzufügen, um Metadaten bereitzustellen, die möglicherweise dynamisch generiert werden, während der Nachrichtenkörper gesendet wird.
Hinweis:
Der TE
Anforderungs-Header muss auf trailers
gesetzt werden, um Trailer-Felder zuzulassen.
Warnung:
Entwickler können über die Fetch API oder XHR nicht auf HTTP-Trailer zugreifen.
Zusätzlich ignorieren Browser HTTP-Trailer, mit Ausnahme von Server-Timing
.
Für weitere Informationen siehe Browser-Kompatibilität.
Syntax
Trailer: header-names
Direktiven
header-names
-
HTTP-Header-Felder, die im Trailer-Teil von chunked Nachrichten vorhanden sein werden. Die folgenden Header-Namen sind nicht erlaubt:
Content-Encoding
,Content-Type
,Content-Range
, undTrailer
- Authentifizierungs-Header (z.B.
Authorization
oderSet-Cookie
) - Nachrichten-Rahmen-Header (z.B.
Transfer-Encoding
undContent-Length
) - Routing-Header (z.B.
Host
) - Anforderungsmodifikatoren (z.B. Steuerelemente und Konditionale, wie
Cache-Control
,Max-Forwards
, oderTE
)
Beispiele
Server-Timing als HTTP-Trailer
Einige Browser unterstützen das Anzeigen von Server-Timing-Daten in den Entwicklerwerkzeugen, 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 |