Class MemoryCache<T>

In-memory cache implementation using a JavaScript Map. Fast and simple, but data is lost when the process exits.

Example

const cache = new MemoryCache<string>({
  defaultTtl: 5000,
  verbose: true,
  logPrefix: '[EntityCache]',
  namespace: 'medical'
});

await cache.set('disease:diabetes', 'Type 2 Diabetes Mellitus');
const result = await cache.get('disease:diabetes');

Type Parameters

  • T = any

    The type of values stored in the cache

Hierarchy (view full)

Constructors

constructor

Properties

config logger stats

Methods

buildKey clear createCacheEntry delete get getStats has isExpired keys log resetStats set size updateStats

Constructors

constructor

Properties

config

config: node.common.apis.cache.CacheConfig

Cache configuration

logger

logger: any

Protectedstats

stats: node.common.apis.cache.CacheStats

Methods

ProtectedbuildKey

  • buildKey(key): string
  • Protected

    Builds a full cache key by combining prefix, namespace, and the provided key.

    Parameters

    • key: string

      The base cache key

    Returns string

    The fully qualified cache key

clear

  • clear(): Promise<void>

  • Removes all entries from the cache. Must be implemented by concrete cache classes.

    Returns Promise<void>

ProtectedcreateCacheEntry

delete

  • delete(key): Promise<boolean>

  • Removes a specific key from the cache.

    Parameters

    • key: string

      The cache key to delete

    Returns Promise<boolean>

    True if the key was successfully deleted

get

  • get(key): Promise<null | T>

  • Retrieves a value from the memory cache.

    Parameters

    • key: string

      The cache key to retrieve

    Returns Promise<null | T>

    The cached value or null if not found or expired

getStats

has

  • has(key): Promise<boolean>

  • Checks if a key exists in the cache and is not expired.

    Parameters

    • key: string

      The cache key to check

    Returns Promise<boolean>

    True if the key exists and is valid

ProtectedisExpired

  • isExpired(entry): boolean
  • Protected

    Checks if a cache entry has expired based on its expiration timestamp.

    Parameters

    Returns boolean

    True if the entry has expired

keys

  • keys(): Promise<string[]>

  • Returns all keys currently stored in the cache. Filters out expired entries and returns the original keys without prefixes.

    Returns Promise<string[]>

    Array of all cache keys

Protectedlog

  • log(message, data?): void
  • Protected

    Logs a message if verbose logging is enabled.

    Parameters

    • message: string

      The log message

    • Optionaldata: any

      Optional additional data to log

    Returns void

resetStats

  • resetStats(): void

  • Resets all cache statistics to zero.

    Returns void

set

  • set(key, value, options?): Promise<void>

  • Stores a value in the memory cache.

    Parameters

    Returns Promise<void>

size

  • size(): Promise<number>

  • Returns the number of valid (non-expired) entries in the cache.

    Returns Promise<number>

    Current cache size

ProtectedupdateStats

  • updateStats(operation, context?): void
  • Protected

    Updates cache statistics for performance monitoring.

    Parameters

    • operation:
          | "set"
          | "delete"
          | "hit"
          | "miss"

      The type of operation that occurred

    • Optionalcontext: {
          fullKey?: string;
          key?: string;
          reason?: string;
          [key: string]: any;
      }

      Additional context for hit/miss logging

      • [key: string]: any
      • OptionalfullKey?: string
      • Optionalkey?: string
      • Optionalreason?: string

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Methods