fresh
Advanced tools
Package description
The 'fresh' npm package is a HTTP response freshness testing library. It is used to determine whether the response is still 'fresh' in the context of HTTP caching. It checks the request and response headers to decide if the response should be re-used or if a new one needs to be generated.
Freshness Checking
This feature allows you to check if the HTTP response is still fresh by comparing the request and response headers. If the function returns true, the response is considered fresh.
const fresh = require('fresh');
const reqHeaders = { 'if-none-match': 'some-etag' };
const resHeaders = { 'etag': 'some-etag' };
const isFresh = fresh(reqHeaders, resHeaders);
console.log(isFresh); // true or falseThe 'etag' package is used to generate HTTP ETags, which are typically used in HTTP headers to determine change in content at a given URL. While 'fresh' is used to check the freshness of responses, 'etag' helps in generating the identifiers that 'fresh' would use for its comparisons.
The 'cache-control' package is used for parsing and formatting HTTP 'Cache-Control' headers. Unlike 'fresh', which checks for response freshness, 'cache-control' is more focused on providing utilities for working with the 'Cache-Control' header directly.
Similar to 'etag', the 'last-modified' package is used for generating and formatting 'Last-Modified' HTTP response headers. It serves a similar purpose in the caching validation process as 'fresh', but from the perspective of generating and handling 'Last-Modified' headers rather than evaluating freshness.
Readme
HTTP response freshness testing
$ npm install fresh
var fresh = require('fresh')
Check freshness of req and res headers.
When the cache is "fresh" true is returned, otherwise false is returned to indicate that the cache is now stale.
var req = { 'if-none-match': 'tobi' };
var res = { 'etag': 'luna' };
fresh(req, res);
// => false
var req = { 'if-none-match': 'tobi' };
var res = { 'etag': 'tobi' };
fresh(req, res);
// => true
FAQs
HTTP response freshness testing
The npm package fresh receives a total of 19,924,525 weekly downloads. As such, fresh popularity was classified as popular.
We found that fresh demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
NIST's new AI Risk Management Framework aims to enhance the security and reliability of generative AI systems and address the unique challenges of malicious AI exploits.
Security News
This episode of the Risky Biz podcast discusses how the rise of small open source packages and the shift towards individual maintainers makes the ecosystem more vulnerable to supply chain attacks.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.