Warning header

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Hinweis: Der Header wurde als veraltet gekennzeichnet, weil er nicht häufig generiert oder den Benutzern angezeigt wird (siehe RFC9111). Einige der Informationen können aus anderen Headern wie Age abgeleitet werden.

Der HTTP-Warning-Anfrage und Antwort-Header enthält Informationen über mögliche Probleme mit dem Status der Nachricht. Mehr als ein Warning-Header kann in einer Antwort erscheinen.

Warning-Header-Felder können im Allgemeinen auf jede Nachricht angewendet werden. Einige Warn-Codes sind jedoch spezifisch für Caches und können nur auf Antwortnachrichten angewendet werden.

Header-Typ Anfrage-Header, Antwort-Header
Verbotener Anfrage-Header Nein

Syntax

http
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]

Anweisungen

<warn-code>

Eine dreistellige Warnnummer. Die erste Ziffer gibt an, ob der Warning gelöscht werden muss, nachdem eine gespeicherte Antwort validiert wurde.

  • 1xx-Warn-Codes beschreiben den Frische- oder Validierungsstatus der Antwort und werden nach erfolgreicher Validierung durch einen Cache gelöscht.
  • 2xx-Warn-Codes beschreiben einen Aspekt der Darstellung, der nicht durch eine Validierung behoben wird und nicht von einem Cache nach der Validierung gelöscht wird, es sei denn, es wird eine vollständige Antwort gesendet.
<warn-agent>

Der Name oder das Pseudonym des Servers oder der Software, die den Warning-Header hinzufügt (kann "-" sein, wenn der Agent unbekannt ist).

<warn-text>

Ein Beratungstext, der den Fehler beschreibt.

<warn-date> Optional

Ein Datum. Wenn mehr als ein Warning-Header gesendet wird, geben Sie ein Datum an, das mit dem Date-Header übereinstimmt.

Warn-Codes

Das HTTP Warn Codes Register bei iana.org definiert den Namensraum für Warn-Codes.

Code Text Beschreibung
110 Response is Stale Die von einem Cache bereitgestellte Antwort ist veraltet (die für die Antwort gesetzte Ablaufzeit ist abgelaufen).
111 Revalidation Failed Ein Versuch, die veraltete Antwort zu validieren, scheiterte aufgrund einer Unfähigkeit, den Server zu erreichen.
112 Disconnected Operation Der Cache ist absichtlich vom Rest des Netzwerks getrennt.
113 Heuristic Expiration Ein Cache hat heuristisch eine Frische-Lebensdauer von mehr als 24 Stunden gewählt, und das Alter der Antwort ist größer als 24 Stunden.
199 Miscellaneous Warning Beliebige Informationen, die einem Benutzer präsentiert oder protokolliert werden sollten.
214 Transformation Applied Wird von einem Proxy hinzugefügt, wenn er eine Transformation an der Darstellung vornimmt, z. B. durch Veränderung der Inhaltscodierung, des Medientyps oder Ähnlichem.
299 Miscellaneous Persistent Warning Beliebige Informationen, die einem Benutzer präsentiert oder protokolliert werden sollten. Dieser Warn-Code ist ähnlich dem Warn-Code 199 und zusätzlich ein Hinweis auf eine persistente Warnung.

Beispiele

http
Warning: 110 anderson/1.3.37 "Response is stale"

Date: Wed, 21 Oct 2015 07:28:00 GMT
Warning: 112 - "cache down" "Wed, 21 Oct 2015 07:28:00 GMT"

Spezifikationen

Specification
HTTP Caching
# field.warning

Browser-Kompatibilität

Siehe auch