Have ideas to improve npm?Join in the discussion! »

    TypeScript icon, indicating that this package has built-in type declarations

    0.7.0 • Public • Published


    npm version Build Status

    Implementing your own Cache

    Internally, Apollo Server uses the KeyValueCache interface to provide a caching store for the Data Sources. An in-memory LRU cache is used by default, and we provide connectors for Memcached/Redis backends.

    Built with extensibility in mind, you can also implement your own cache to use with Apollo Server, in a way that best suits your application needs. It needs to implement the following interface that can be exported from apollo-server-caching:

    export interface KeyValueCache {
      get(key: string): Promise<string | undefined>;
      set(key: string, value: string, options?: { ttl?: number }): Promise<void>;

    The ttl value for the set method's options is specified in seconds.

    Testing cache implementations

    Test helpers

    You can export and run a jest test suite from apollo-server-caching to test your implementation:

    // ../__tests__/YourKeyValueCache.test.ts
    import YourKeyValueCache from '../src/YourKeyValueCache';
    import { testKeyValueCache } from 'apollo-server-caching';
    testKeyValueCache(new MemcachedCache('localhost'));

    The default testKeyValueCache helper will run all key-value store tests on the specified store, including basic get and set functionality, along with time-based expunging rules.

    Some key-value cache implementations may not be able to support the full suite of tests (for example, some tests might not be able to expire based on time). For those cases, there are more granular implementations which can be used:

    • testKeyValueCache_Basic
    • testKeyValueCache_Expiration

    For more details, consult the source for apollo-server-caching.

    Running tests

    Run tests with jest --verbose




    npm i apollo-server-caching

    DownloadsWeekly Downloads






    Unpacked Size

    21 kB

    Total Files


    Last publish


    • avatar