express-cache-middleware
An Express middleware designed to intercept responses and cache them.
master:
Usage
To use this middleware, first instantiate it. The first argument to the constructor must be a cache-manager .caching()
instance, initialized with any backend you choose. The second argument is an optional object of options.
const express = require('express')
const ExpressCache = require('express-cache-middleware')
const cacheManager = require('cache-manager')
const cacheMiddleware = new ExpressCache(
cacheManager.caching({
store: 'memory', max: 10000, ttl: 3600
})
)
Then, attach it to your Express app instance or Router. Any routes attached to the app or Router after this will be intercepted and cached.
cacheMiddleware.attach(app)
app.all('*', (req, res) => {
res.send('response')
})
app.listen()
Please see the options for important information about handling incoming and outgoing data.
Options
getCacheKey
A function to get the cache key from the request. Provided with one argument: the request object from Express.
By default, this is a function that returns the request URL.
You may want to customize this function if you anticipate that there are things in your URL that you don't want in your cache key. For example, you can remove irrelevant query parameters or subdirectories by parsing the URL here and returning the cache key.
hydrate
Because this middleware is backend-agnostic, it makes no assumptions about what you want to do with cached data. By default, it just passes the streamed data out as the response, and what this data actually is will depend on your chosen cache-manager backend since no metadata side-channel is available.
This usually ends up as a response with Content-Type: application/octet-stream
, which is not often what people want. To fix this, hydrate
is run before the content is returned.
hydrate
is called with four arguments:
req
, the Express request objectres
, the Express response objectdata
. the data returned from cachecb
, an optional callback function
Set any headers or perform any transformations on the returned data. Then, call the callback with (err, result)
or return a Promise.
Note: hydrate
is not called for the first response, where your route returns its original content-- only for cache hits.
Example for handling image responses:
const fileType = require('file-type')
const cacheMiddleware = new ExpressCache(
cacheManager.caching({
store: 'memory', max: 10000, ttl: 3600
}), {
hydrate: (req, res, data, cb) => {
const guess = fileType(data.slice(0, 4101))
if( guess ) {
res.contentType(guess.mime)
}
cb(null, data)
}
}
)
const hydrateWithPromise = (res, data) => {
return Promise.resolve(data)
}
const hydrateAsync = async (res, data) => {
return data
}
Example for handling mixed content responses:
const hydrateManyThings = async (req, res, data) => {
try {
JSON.parse(data)
res.contentType('application/json')
return data
} catch ( err ) {}
const guess = fileType(data.slice(0, 4101))
if( guess ) {
res.contentType(guess.mime)
}
return data
}
Changelog
1.0.1
Removes mung's json as it was setting cache multiple times. send
will catch json as well.
Alters Promise detection from hydrate
functions-- async
was not being detected as Promises.
Updated dev dependencies, added babel-jest-assertions to ensure the tests are running properly, and minor linting
1.0.0
First full release, using fork of express-mung