axios-cache-interceptor

  

  
🗄️📦💿
Axios Cache Interceptor
  

  

This library is in beta and can have breaking changes until v1.
Not ready for production usage!

axios-cache-interceptor is a axios wrapper for caching and preventing unneeded requests

import axios from 'axios';
import { createCache, SessionCacheStorage } from 'axios-cache-interceptor';

// Any custom axios instance
const api = axios.create();

// Other axios instance with caching enabled
const cachedApi = createCache(api, {
  // Store values on window.sessionStorage
  storage: new SessionCacheStorage(),

  // Use the max-age header to determine the cache expiration time
  interpretHeader: true
});

// Make a simple request, with caching support, to the api
const { data } = await cachedApi.get('https://api.example.com/');

Installing

Axios is a peer dependency and must be installed separately.

# Npm
npm install --save axios axios-cache-interceptor

# Yarn
yarn add axios axios-cache-interceptor

Inspiration

This project is highly inspired by several projects, written entirely in typescript, supporting https headers and much more.

Take a look at some similar projects:

• axios-cache-adapter
• axios-cache-plugin
• @tusbar/cache-control

License

Licensed under the MIT. See LICENSE for more informations.

Contact

See my contact information on my github profile or open a new issue.

Changelog

v0.2.0 - 2021-09-20

Merged

• chore(deps-dev): bump @types/node from 16.9.2 to 16.9.4 #14
• chore(deps-dev): bump @types/node from 16.9.1 to 16.9.2 #13
• chore(deps-dev): bump prettier from 2.4.0 to 2.4.1 #12

Commits

• chore: changelog generation 4363f65
• feat: enable cache by creating or applying f4bbd8b
• fix: a bunch of tests 6075a0a
• fix: axios headers are lowercased 1f88779
• fix: concurrent requests not beeing cached 1490bfc
• refactor: interceptors in classes f1033a5
• refactor: renamed status constants 6e61c0d
• refactor: requests ids can also be symbol 38133a7
• style: prettified code 45630e3
• tag: v0.2.0 8228045
• tag: v0.2.0 3ae95cf