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 weit verbreitet erzeugt oder den Nutzern 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
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]
Direktiven
<warn-code>-
Eine dreistellige Warnnummer. Die erste Ziffer zeigt an, ob der
Warningnach der Validierung aus einer gespeicherten Antwort gelöscht werden muss.1xx-Warn-Codes beschreiben die Frische oder 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, eine vollständige Antwort wird 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 demDate-Header entspricht.
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 festgelegte Ablaufzeit ist abgelaufen). |
| 111 | Revalidation Failed | Ein Versuch, die veraltete Antwort zu validieren, ist gescheitert, weil 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 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 | Von einem Proxy hinzugefügt, wenn er eine Transformation an der Repräsentation vornimmt, wie das Ändern der content-coding, des media-type oder Ähnlichem. |
| 299 | Miscellaneous Persistent Warning | Beliebige Informationen, die einem Benutzer präsentiert oder protokolliert werden sollten. Dieser Warn-Code ist ähnlich wie der Warn-Code 199 und zeigt zusätzlich eine dauerhafte 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
| Spezifikation |
|---|
| HTTP Caching> # field.warning> |