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 Anforderung der Ressource bedingt. Der Server sendet die angeforderte Ressource (oder akzeptiert sie im Falle einer POST oder einer anderen nicht-sicheren Methode) nur, wenn die Ressource auf dem Server seit dem Datum im Request-Header nicht geändert wurde. Wenn die Ressource nach dem angegebenen Datum geändert wurde, lautet 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 bei einigen Wikis der Fall ist: Änderungen werden abgelehnt, wenn das gespeicherte Dokument seit der ursprünglichen Abrufung geändert wurde, um Konflikte zu vermeiden.
  • In Verbindung mit einer Bereichsabfrage unter Verwendung des Range-Headers kann dieser Header verwendet werden, um sicherzustellen, dass das neu angeforderte Fragment von 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ß-/Kleinschreibung beachten).

<day>

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

<month>

Einer von Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec (Groß-/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 sind immer in GMT angegeben, niemals in Ortszeit.

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