keq-cache

Usage

import { request } from "keq";
import { cache, Strategy } from "keq-cache";

request.use(cache());

By default, NetworkOnly Strategy and Memory Storage will be used for all request. And you can customize the global configuration:

import { request } from "keq";
import { cache, Strategy } from "keq-cache";

request
  .use(
    cache({
      rules: [
        {
          pattern: (ctx) => ctx.request.method === "get",
          strategy: Strategy.STALE_WHILE_REVALIDATE,
          ttl: 5 * 60 * 1000,
        },
      ],
    })
  );

The above configuration, all GET request will use StateWileRevalidate Strategy and cache will expire after 5 minutes.

It is natural to override the global configuration when sending a request:

import { request } from "keq";
import { cache, Strategy, Eviction } from "keq-cache";

request
  .get("/example")
  .option({
    cache: {
      strategy: Strategy.NETWORK_FIRST,
      key: 'custom-cache-key',
      ttl: 1000,
    },
  });

Configuration

Name	Default	Description
storage	Storage.Memory	See More
maxStorageSize	2MB	Maximum storage space occupied by the cache. If exceeded, some cache will be removed according to the Eviction.
threshold	0.2 * maxStorageSize	If a request size is greater than threshold, it will not be cached. Don't be larger than maxStorageSize
Eviction	VolatileTTL	Eviction policies when memory is insufficient. See More
keyFactory	(context) => context.identifier	The requested cache unique key factory. Requests with the same key will share the cache
rules.pattern	-
rules.key	-	The cache key factory for the request match the rule.
rules.strategy	NetworkFirst	how generates a response after receiving a fetch. See More
rules.ttl	Infinity	cache time to live

Storage

Memory

Store the cache in memory and make it invalid after the page is refreshed.

IndexedDB

Storing the cache in IndexedBD that avoid cache invalid after refresh pages.

Strategies

StaleWhileRevalidate

CacheFirst

NetworkFirst

NetworkOnly

CacheOnly

Eviction

LRU

Keeps most recently used keys; removes least recently used (LRU) keys

淘汰整个键值中最久未使用的键值

Random

Randomly removes keys to make space for the new data added.

随机淘汰任意键值

LFU

Keeps frequently used keys; removes least frequently used (LFU) keys

淘汰整个键值中最少使用的键值

TTL

Removes keys with expire field set to true and the shortest remaining time-to-live (TTL) value

优先淘汰更早过期的键值