fresh_when
- 1.0.0
- 1.1.6
- 1.2.6
- 2.0.3
- 2.1.0
- 2.2.1
- 2.3.8
- 3.0.0 (0)
- 3.0.9 (-1)
- 3.1.0 (0)
- 3.2.1 (10)
- 3.2.8 (0)
- 3.2.13 (0)
- 4.0.2 (0)
- 4.1.8 (0)
- 4.2.1 (14)
- 4.2.7 (0)
- 4.2.9 (0)
- 5.0.0.1 (38)
- 5.1.7 (0)
- 5.2.3 (0)
- 6.0.0 (0)
- 6.1.3.1 (0)
- 6.1.7.7 (0)
- 7.0.0 (10)
- 7.1.3.2 (0)
- 7.1.3.4 (0)
- What's this?
fresh_when(record_or_options, additional_options = {})
public
Sets the etag, last_modified, or both on the response and renders a 304 Not Modified response if the request is already fresh.
Parameters:
-
:etag.
-
:last_modified.
-
:public By default the Cache-Control header is private, set this to true if you want your application to be cachable by other devices (proxy caches).
Example:
def show @article = Article.find(params[:id]) fresh_when(etag: @article, last_modified: @article.created_at, public: true) end
This will render the show template if the request isn’t sending a matching etag or If-Modified-Since header and just a 304 Not Modified response if there’s a match.
You can also just pass a record where last_modified will be set by calling updated_at and the etag by passing the object itself.
def show @article = Article.find(params[:id]) fresh_when(@article) end
When passing a record, you can still set whether the public header:
def show @article = Article.find(params[:id]) fresh_when(@article, public: true) end