up.protocol X-Up-Expire-Cache

HTTP header

The server may send this optional response header to control which previously cached responses should be expired when this response is received.

The value of this header is a URL pattern matching responses that should be expired.

For example, to expire all responses to URLs starting with /notes/:

X-Up-Expire-Cache: /notes/*

To expire all cache entries:

X-Up-Expire-Cache: *

To expire nothing beyond what the client has already expired, send false:

X-Up-Expire-Cache: false

Relation to the client-side default

When Unpoly sends a non-GET request, it expires the entire cache before the server responds. This header can only expire additional entries. It cannot undo an expiration that has already happened.

To keep the cache fresh after a non-GET request, configure the client instead. For example, set an [up-expire-cache="false"] attribute on the link or form, or customize up.network.config.expireCache.