About
A conditional get request or cache validation request is a conditional request made by the user agent to see if a stale resource is still valid.
Example
If conditional headers leads to conditional requests. For instance:
If-Modified-Since: Sat, 07 Feb 2015 16:44:03 GMT
If-None-Match: "e026b5aa0e4be8d990f093176b3dcb7f"
Note that you can get one or both from the user agent (browser)
Header
This conditional headers leads to conditional requests:
| Headers | Cache Validator | Condition |
|---|---|---|
| If-Match | ETag | The Etag should be the same |
| If-None-Match | ETag | The Etag should not be the same |
| If-Modified-Since | Last-Modified date | The date should be more recent |
| If-Unmodified-Since | Last-Modified date | The date is older or the same |
| If-Range | ETag or Last-Modified date | Similar to If-Match, or If-Unmodified-Since for range request |
The are known in the specification as Precondition Header Fields
Steps
The original fetch
The browser (or any other user-agent):
- fetch a resource. ie
- performs a get request to a server,
- store it in its cache (browser cache, proxy cache) along with one or more cache validator ie:
This header are called validator header because they will be send back to the server and will then permit to see if the resource has changed since the last fetch (hence validating the freshness of the cache).
The cache is empty
and the request is not conditional Client->>Server: GET /doc/resource HTTP/1.1 Note right of Server: Resource Returned
One ore more validators are set Server->>Client: HTTP/1.1 200 OK
Last-Modified: date
Etag: "xyx"
The conditional request
When the resource becomes stale in the cache, the client may send a condition request to see if the resource is still valid. If this is the case and that the resource has not changed, the server sends back a 304 Not Modified response without the body making the request smaller in size.
The cache becomes fresh again, and the client uses the cached resource.
The cache is stal
A cache validation request
is send
with the conditional and
validator headers
Client->>Server: GET /doc/resource HTTP/1.1
If-Modified-Since
If-None-Match
Etag
Last-Modified Note right of Server: The server checks
if the resource has changed
with the validators
and returns a 304 or 200
alt if the resource has not changed (without body) Server->>Client: HTTP/1.1 304 OK
Last-Modified: date
Etag: "xyx" else if the resource has changed (with the body) Server->>Client: HTTP/1.1 200 OK
Last-Modified: date
Etag: "xyx" end