https://github.com/mgechev/memo-decorator
Decorator which applies memoization to a method of a class.
https://github.com/mgechev/memo-decorator
decorators memo-decorator memoization
Last synced: 2 months ago
JSON representation
Decorator which applies memoization to a method of a class.
- Host: GitHub
- URL: https://github.com/mgechev/memo-decorator
- Owner: mgechev
- Created: 2018-01-28T01:19:10.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-05T18:12:11.000Z (over 2 years ago)
- Last Synced: 2025-03-28T08:09:12.536Z (3 months ago)
- Topics: decorators, memo-decorator, memoization
- Language: TypeScript
- Homepage:
- Size: 525 KB
- Stars: 258
- Watchers: 6
- Forks: 8
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://travis-ci.org/mgechev/memo-decorator)
# Memo Decorator
This decorator applies memoization to a method of a class.
## Usage
Apply the decorator to a method of a class. The cache is local for the method but shared among all instances of the class. Strongly recommend you to **use this decorator only on pure methods.**
Installation:
```shell
npm i memo-decorator --save
```
### Configuration
```ts
export interface Config {
resolver?: Resolver;
cache?: MapLike;
}
```
- `Resolver` is a function, which returns the key to be used for given set of arguments. By default, the resolver will use the first argument of the method as the key.
- `MapLike` is a cache instance. By default, the library would use `Map`.
Example:
```typescript
import memo from 'memo-decorator';
class Qux {
@memo({
resolver: (...args: any[]) => args[1],
cache: new WeakMap()
})
foo(a: number, b: number) {
return a * b;
}
}
```
### Demo
```typescript
import memo from 'memo-decorator';
class Qux {
@memo()
foo(a: number) {
console.log('foo: called');
return 42;
}
@memo({
resolver: _ => 1
})
bar(a: number) {
console.log('bar: called');
return 42;
}
}
const a = new Qux();
// Create a new cache entry and associate `1` with the result `42`.
a.foo(1);
// Do not invoke the original method `foo` because there's already a cache
// entry for the key `1` associated with the result of the method.
a.foo(1);
// Invoke the original `foo` because the cache doesn't contain an entry
// for the key `2`.
a.foo(2);
// Invoke `bar` and return the result `42` gotten from the original `bar` implementation.
a.bar(1);
// Does not invoke the original `bar` implementation because of the specified `resolver`
// which is passed to `memo`. For any arguments of the function, the resolver will return
// result `1` which will be used as the key.
a.bar(2);
const b = new Qux();
// Does not invoke the method `foo` because there's already an entry
// in the cache which associates the key `1` to the result `42` from the
// invocation of the method `foo` by the instance `a`.
b.foo(1);
// Outputs:
// foo: called
// foo: called
// bar: called
```
## License
MIT