If-Unmodified-Since header

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der HTTP-If-Unmodified-Since-Request-Header macht die Anfrage nach der Ressource bedingt. Der Server sendet die angeforderte Ressource (oder akzeptiert sie im Falle eines POST oder einer anderen nicht-sicheren Methode) nur, wenn die Ressource auf dem Server nach dem Datum im Request-Header nicht verändert wurde. Wenn die Ressource nach dem angegebenen Datum verändert wurde, ist die Antwort ein 412 Precondition Failed-Fehler.

Der If-Unmodified-Since-Header wird häufig in den folgenden Situationen verwendet:

  • In Verbindung mit nicht-sicheren Methoden wie POST kann dieser Header verwendet werden, um eine optimistische Nebenläufigkeitskontrolle zu implementieren, wie es von einigen Wikis gemacht wird: Überarbeitungen werden abgelehnt, wenn das gespeicherte Dokument seit dem Abruf des Originals geändert wurde, um Konflikte zu vermeiden.
  • In Verbindung mit einer Bereichsanfrage unter Verwendung des Range-Headers kann dieser Header verwendet werden, um sicherzustellen, dass das neu angeforderte Fragment aus einem unveränderten Dokument stammt.
Header-Typ Request-Header
Verbotener Request-Header Nein

Syntax

http
If-Unmodified-Since: <day-name>, <day> <month> <year> <hour>:<minute>:<second> GMT

Direktiven

<day-name>

Einer von Mon, Tue, Wed, Thu, Fri, Sat oder Sun (Groß- und Kleinschreibung beachten).

<day>

2-stellige Tagesnummer, z.B. "04" oder "23".

<month>

Einer von Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec (Groß- und Kleinschreibung beachten).

<year>

4-stellige Jahreszahl, z.B. "1990" oder "2016".

<hour>

2-stellige Stundenzahl, z.B. "09" oder "23".

<minute>

2-stellige Minutenzahl, z.B. "04" oder "59".

<second>

2-stellige Sekundenzahl, z.B. "04" oder "59".

GMT

Greenwich Mean Time. HTTP-Daten werden immer in GMT ausgedrückt, niemals in lokaler Zeit.

Beispiele

http
If-Unmodified-Since: Wed, 21 Oct 2015 07:28:00 GMT

Spezifikationen

Specification
HTTP Semantics
# field.if-unmodified-since

Browser-Kompatibilität

Siehe auch