Warning

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 erklärt, da er nicht häufig generiert oder den Nutzern angezeigt wird (siehe RFC9111). Einige Informationen können aus anderen Headern wie Age abgeleitet werden.

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

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

Header-Typ Request-Header, Response-Header
Verbotener Header-Name Nein

Syntax

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

Direktiven

<warn-code>

Eine dreistellige Warnungsnummer. Die erste Ziffer gibt an, ob der Warning aus einer gespeicherten Antwort nach der Validierung gelöscht werden muss.

  • 1xx Warn-Codes beschreiben die Frische oder den Validierungsstatus der Antwort und werden von einem Cache nach erfolgreicher Validierung gelöscht.
  • 2xx Warn-Codes beschreiben einen Aspekt der Repräsentation, der durch eine Validierung nicht behoben wird und werden von einem Cache nach der Validierung nicht gelöscht, 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 Hinweistext, der den Fehler beschreibt.

<warn-date> Optional

Ein Datum. Wenn mehr als ein Warning-Header gesendet wird, fügen Sie ein Datum hinzu, das dem Date-Header entspricht.

Warnungscodes

Das HTTP Warn Codes registry bei iana.org definiert den Namensraum für Warnungscodes.

Code Text Beschreibung
110 Response is Stale Die vom Cache bereitgestellte Antwort ist veraltet (die für die Antwort festgelegte Ablaufzeit ist abgelaufen).
111 Revalidation Failed Ein Versuch, die veraltete Antwort zu validieren, ist gescheitert, da der Server nicht erreicht werden konnte.
112 Disconnected Operation Der Cache ist absichtlich vom Rest des Netzwerks getrennt.
113 Heuristic Expiration Ein Cache hat heuristisch eine Frischelebensdauer von mehr als 24 Stunden gewählt und das Alter der Antwort beträgt mehr als 24 Stunden.
199 Miscellaneous Warning Beliebige Informationen, die einem Nutzer präsentiert oder protokolliert werden sollten.
214 Transformation Applied Hinzugefügt von einem Proxy, wenn es eine Transformation an der Repräsentation vornimmt, wie das Ändern der content-coding, media-type oder Ähnlichem.
299 Miscellaneous Persistent Warning Beliebige Informationen, die einem Nutzer präsentiert oder protokolliert werden sollten. Dieser Warn-Code ähnelt dem Warn-Code 199 und weist zusätzlich auf eine anhaltende Warnung hin.

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

BCD tables only load in the browser

Siehe auch