Warning
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.
Hinweis: Der Header wurde als veraltet erklärt, da er nicht häufig generiert oder den Nutzern angezeigt wird (siehe RFC9111).
Einige der Informationen können aus anderen Headern wie Age abgeleitet werden.
Der Warning HTTP-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.
Jedoch sind einige Warncodes spezifisch für Caches und können nur auf Antwortnachrichten angewendet werden.
| Header-Typ | Request-Header, Response-Header |
|---|---|
| Nicht erlaubter Header-Name | nein |
Syntax
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]
Direktiven
- <warn-code>
-
Eine dreistellige Warnnummer. Die erste Ziffer gibt an, ob der
Warningnach einer Validierung aus einer gespeicherten Antwort gelöscht werden muss.1xxWarncodes beschreiben den Frische- oder Validierungszustand der Antwort und werden nach einer erfolgreichen Validierung von einem Cache gelöscht.2xxWarncodes beschreiben einen Aspekt der Repräsentation, der durch eine Validierung nicht behoben wird, und werden 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 Hinweistext, der den Fehler beschreibt.
- <warn-date>
-
Ein Datum. Dies ist optional. Wenn mehr als ein
Warning-Header gesendet wird, fügen Sie ein Datum hinzu, das demDate-Header entspricht.
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 für die Antwort festgelegte Ablauffrist ist abgelaufen). |
| 111 | Revalidation Failed | Ein Versuch, die veraltete Antwort zu validieren, ist aufgrund der Unfähigkeit, den Server zu erreichen, fehlgeschlagen. |
| 112 | Disconnected Operation | Der Cache ist absichtlich vom Rest des Netzwerks getrennt. |
| 113 | Heuristic Expiration | Ein Cache hat heuristisch eine Frischelebensdauer gewählt, die größer als 24 Stunden ist, und das Alter der Antwort ist größer als 24 Stunden. |
| 199 | Miscellaneous Warning | Beliebige Informationen, die einem Nutzer angezeigt oder protokolliert werden sollten. |
| 214 | Transformation Applied | Wird von einem Proxy hinzugefügt, wenn er eine Transformation an der Repräsentation vornimmt, wie z.B. die Änderung der content-coding, media-type oder dergleichen. |
| 299 | Miscellaneous Persistent Warning | Beliebige Informationen, die einem Nutzer angezeigt 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
| Specification |
|---|
| HTTP Caching # field.warning |
Browser-Kompatibilität
BCD tables only load in the browser