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 eingestuft, da er nicht weit verbreitet generiert oder den Benutzern angezeigt wird (siehe RFC9111).
Einige der Informationen können aus anderen Headern abgeleitet werden, wie z.B. Age.
Der HTTP Warning Request-Header und Response-Header enthält Informationen über mögliche Probleme mit dem Status der Nachricht.
Es können mehrere Warning-Header in einer Antwort erscheinen.
Im Allgemeinen können Warning-Header-Felder auf jede Nachricht angewendet werden.
Allerdings sind einige Warncodes spezifisch für Caches und können nur auf Antwortnachrichten angewendet werden.
| Header-Typ | Request-Header, Response-Header |
|---|---|
| Verbotener Request-Header | Nein |
Syntax
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]
Direktiven
<warn-code>-
Eine dreistellige Warnnummer. Die erste Ziffer zeigt an, ob der
Warning-Header nach der Validierung aus einer gespeicherten Antwort gelöscht werden muss.1xxWarncodes beschreiben die Frische oder den Validierungsstatus der Antwort und werden von einem Cache nach erfolgreicher Validierung gelöscht.2xxWarncodes beschreiben einen Aspekt der Darstellung, der durch eine Validierung nicht korrigiert wird, und werden nach der Validierung nicht von einem Cache 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 hinweisender Text, der den Fehler beschreibt.
<warn-date>Optional-
Ein Datum. Wenn mehr als ein
Warning-Header gesendet wird, fügen Sie ein Datum ein, das mit demDateHeader übereinstimmt.
Warncodes
Das HTTP Warn Codes-Register bei iana.org definiert den Namensraum für Warncodes.
| Code | Text | Beschreibung |
|---|---|---|
| 110 | Response is Stale | Die von einem Cache bereitgestellte Antwort ist veraltet (die festgelegte Ablaufzeit für die Antwort ist abgelaufen). |
| 111 | Revalidation Failed | Ein Versuch, die veraltete Antwort zu validieren, schlug aufgrund der Unfähigkeit, den Server zu erreichen, fehl. |
| 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 Benutzer angezeigt oder protokolliert werden sollten. |
| 214 | Transformation Applied | Wird von einem Proxy hinzugefügt, wenn es eine Transformation auf die Darstellung anwendet, wie z.B. das Ändern des content-coding, media-type oder Ähnliches. |
| 299 | Miscellaneous Persistent Warning | Beliebige Informationen, die einem Benutzer angezeigt oder protokolliert werden sollten. Dieser Warncode ist dem Warncode 199 ähnlich und zeigt zusätzlich eine anhaltende Warnung an. |
Beispiele
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 |