Getter decorator that memoises the return value
npm install lazy-get-decoratorimport {LazyGetter} from 'lazy-get-decorator';
class MyClass {
@LazyGetter(/* optional config */)
get foo(): number {
// ...
}
@LazyGetter(/* optional config */)
static get bar(): string {
// ...
}
}All options are optional
| Name | Type | Default | Description |
|---|---|---|---|
global |
boolean |
false |
If set to true, the lazy getter triggering on one class instance will end up saving the returned value on all class instances, current and future. Has no effect on static getters. |
select |
<T, R>(this: T, output: R, self: T) => any |
A function to determine whether we should save the results (returning a truthy value) or continue calling the original getter (returning a falsy value). The default behaviour is to always save the 1st result. |
The following example will save the value only if the counter is 10 or above. The selector executes after the getter
function, hence the offset of 1: the current value of 9 is returned and passed on to the result selector, but the
counter value is already incremented at this point.
class MyClass {
#counter = 0;
@LazyGetter({select: v => v === 9})
get timesAccessed(): number {
return this.#counter++;
}
}The library's only goal is to be compatible with Typescript 5 decorators which, at the time of writing, use the 2022-03 stage 3 decorators proposal. If you need experimental TS decorators or can't use a suitable Babel transform just stick to v2 - there are no new features in this release.
Typescript has further gotchas depending on the compiler target you've set.
ES2022 and higher allows you to use a class' method as a result selector:
class MyClass {
static shouldMemoiseStatic = false;
shouldMemoiseInstance = true;
@LazyGetter({select: MyClass.bar})
static get foo() {}
@LazyGetter({select: MyClass.prototype.bar2})
get foo2() {}
static bar() {
return this.shouldMemoiseStatic;
}
bar2() {
return this.shouldMemoiseInstance;
}
}Attempting to do this on ES2021 or lower will result in a runtime error as of Typescript 5.2.
- The function signature has changed to accept an object instead of multiple arguments
makeNonConfigurableoption removedsetProtooption renamed toglobal- The only officially supported version is now the non-experimental decorators of Typescript 5 - see compatibility
- The ability to reset a memoised getter has been removed.
- If you need to do this as part of your unit tests, use a different class every time. The library's test suites have a few variations of this pattern - creating classes through a helper function, running similar tests through a helper function that accepts a class
- If you need this at runtime then it's not a lazy getter you have - add whatever checks you need in your getter's logic and don't decorate it
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "github-actions[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent