next-redis-cache

1.0.3 • Public • Published

Next Redis Cache

Next Redis Cache is a Next.js compatible library for caching server rendered pages to serve faster than ever.

Installation

Use the package manager npm or yarn to install next-redis-cache.

npm install next-redis-cache --save

with yarn package manager.

yarn add next-redis-cache

Usage

To use this package you need to run your app with custom server, read more from here about next.js custom server.

Once you have next.js custom server setup with your app.

Use as a middleware

server.js

const express = require('express')
const next = require('next')
const NextRedisCache = require('next-redis-cache')
 
 
const port = process.env.PORT || 3000
const development = process.env.NODE_ENV !== 'production'
const app = next({ dev: development })
const handler = app.getRequestHandler()
const client = redis.createClient()
 
/**
 *  Initialization of Next Redis Cache instance
 */
const nextRedisCache = new NextRedisCache(client, app, {
  includes: ['/'],  // routes to include for caching
})
 
app
  .prepare()
  .then(() => {
    const server = express()
 
    server.get('*', 
      (request, response, nxt) => nextRedisCache.middleware(request, response, nxt), 
      (request, response) => handler(request, response)
    )
 
    /* starting server */
    return server.listen(port, error => {
      if (error) throw error
      console.log(`> Ready on http://localhost:${port}`)
    })
  })
  .catch(error => new Error("Server isn't responded", error))
 

Use as a handler

  • To use Next Redis Cache as a request handler just replace Next.js app's handler with nextRedisCache.handler in above snippet, as give in-below.

server.js

    server.get('*', (request, response) =>
      nextRedisCache.handler(request, response)
    )

Here, Instance of NextRedisCache initialized with three arguments as following.

Name Type Required Default
Client Redis Client
App Next.js App
Config Configuration Object {}

Configuration

Next Redis Cache comes with some extra controls to manage your redis database and page's caching. ( it's all in your hand ).

All you need to know about config object.

Key Detail Type Example Default
includes Collection of specific routes which should be cache. Array ['/', '/blogs/(.*)'] []
excludes Collection of specific routes which shouldn't be cache. Array ['/cart', '/(.*).js'] [*]
defaultExpire Expiration time to expire you cache after a particular time. Note: null value of this key will set cache permanently. Number (Seconds) 3000 null
expire To define different expiration time for different routes. Number (Seconds) 3000 null
cache To disable caching permanently by setting it false. Boolean true true
prefix To identify your cache in store by unique prefix. String "my-cache" "my-cache"
log Log timing of get/set to monitor caching Boolean true false

Note : includes and excludes is using path-to-regexp to validate routes.

Contributing

Pull requests are welcome. For major/valid changes or task from to-do, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

To Do

  • Define Test Cases

License

MIT

Package Sidebar

Install

npm i next-redis-cache

Weekly Downloads

16

Version

1.0.3

License

MIT

Unpacked Size

15.8 kB

Total Files

7

Last publish

Collaborators

  • chavda-bhavik
  • rajnishkatharotiya