Skip to content

brn/cache-decorator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What's this?

cache-decorator is function/method cache implementation of ES decorator.

Installation

npm install cache-decorator --save

or

yarn add cache-decorator --save

Usage

Method cache.

For javascript/babel

import {
  cache,
  CacheType,
  CacheScope
} from 'cache-decorator';

class Example {
  @cache({type: CacheType.MEMO, scope: CacheScope.INSTANCE})
  expensiveCalc(args) {...}
}

For typescript

tsconfig.json

{
  "compilerOptions": {
    ...
    paths: {
      "cache-decorator": ["node_modules/cache-decorator/lib/index.d.ts"]
    }
  },
}
import {
  cache,
  CacheType,
  CacheScope
} from 'cache-decorator';

class Example {
  @cache({type: CacheType.MEMO, scope: CacheScope.INSTANCE})
  public expensiveCalc(args) {...}
}

Function cache

For javascript/babel

import {
  fcache,
  CacheType
} from 'cache-decorator';

const cachedFn = fcache((args) => {
  ...
}, {type: CacheType.MEMO})

For typescript

tsconfig.json

{
  "compilerOptions": {
    ...
    paths: {
      "cache-decorator": ["node_modules/cache-decorator/lib/index.d.ts"]
    }
  },
}
import {
  cache,
  CacheType,
  CacheScope
} from 'cache-decorator';

const cachedFn = fcache((args: Object) => {
  ...
}, {type: CacheType.MEMO})

Cache Options

interface CacheOption {
  type?: CacheType;
  scope?: CacheScope;
  ttl?: number;
  compare?: (prev: any, next: any) => boolean;
}

type: CacheType

default value: CacheType.SINGLETON

SINGLETON

    1. Search caches.
    1. If found, return cache value, otherwise call function and set result to cache.
    1. Return result.

MEMO

    1. Search caches with passed arguments and compare them with other cached arguments.
    1. If value is found, return it otherwise call function and set pair of return value and arguments to cache.
    1. Return result.

scope: CacheScope

default value: CacheScope.INSTANCE

INSTANCE

Cache value is reserved in class instance, so new instance will be created, that instance has't have any cache value.
Every instance has self cache.

GLOBAL

Reserve cache value to global area, so new instance will be created, but that instance return same cached value.

ttl: number

default value: null

If ttl was specified, cached value was removed after specified milliseconds.

compare: Function

default value: (a, b) => a.length === b.length && a.every((v, i) => v === b[i])

Arguments comparison function used if type is MEMO.
Default value of this options is compare ===.

Contribute

Fork!

yarn run ut
yarn run minify

Send PR!

About

javascript method/function cache decorator.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published