Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/developit/decko
:dash: The 3 most useful ES7 decorators: bind, debounce and memoize
https://github.com/developit/decko
debounce decorators memoization memoize throttle-calls
Last synced: about 2 months ago
JSON representation
:dash: The 3 most useful ES7 decorators: bind, debounce and memoize
- Host: GitHub
- URL: https://github.com/developit/decko
- Owner: developit
- License: mit
- Created: 2015-08-24T01:30:40.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-10-12T22:33:20.000Z (almost 6 years ago)
- Last Synced: 2024-06-18T12:29:23.923Z (3 months ago)
- Topics: debounce, decorators, memoization, memoize, throttle-calls
- Language: JavaScript
- Homepage: https://developit.github.io/decko/
- Size: 49.8 KB
- Stars: 1,034
- Watchers: 15
- Forks: 50
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-star - decko
- awesome-list - decko
README
# decko [](https://npmjs.com/package/decko) [](https://travis-ci.org/developit/decko)
A concise implementation of the three most useful [decorators](https://github.com/wycats/javascript-decorators):
- `@bind`: make the value of `this` constant within a method
- `@debounce`: throttle calls to a method
- `@memoize`: cache return values based on arguments
Decorators help simplify code by replacing the noise of common patterns with declarative annotations.
Conversely, decorators can also be overused and create obscurity.
Decko establishes 3 standard decorators that are immediately recognizable, so you can avoid creating decorators in your own codebase.
> 💡 **Tip:** decko is particularly well-suited to [**Preact Classful Components**](https://github.com/developit/preact).
>
> 💫 **Note:**
> - For Babel 6+, be sure to install [babel-plugin-transform-decorators-legacy](https://github.com/loganfsmyth/babel-plugin-transform-decorators-legacy).
> - For Typescript, be sure to enable `{"experimentalDecorators": true}` in your tsconfig.json.
## Installation
Available on [npm](https://npmjs.com/package/decko):
```sh
npm i -S decko
```
## Usage
Each decorator method is available as a named import.
```js
import { bind, memoize, debounce } from 'decko';
```
### `@bind`
```js
class Example {
@bind
foo() {
// the value of `this` is always the object from which foo() was referenced.
return this;
}
}
let e = new Example();
assert.equal(e.foo.call(null), e);
```
### `@memoize`
> Cache values returned from the decorated function.
> Uses the first argument as a cache key.
> _Cache keys are always converted to strings._
>
> ##### Options:
>
> `caseSensitive: false` - _Makes cache keys case-insensitive_
>
> `cache: {}` - _Presupply cache storage, for seeding or sharing entries_
```js
class Example {
@memoize
expensive(key) {
let start = Date.now();
while (Date.now()-start < 500) key++;
return key;
}
}
let e = new Example();
// this takes 500ms
let one = e.expensive(1);
// this takes 0ms
let two = e.expensive(1);
// this takes 500ms
let three = e.expensive(2);
```
### `@debounce`
> Throttle calls to the decorated function. To debounce means "call this at most once per N ms".
> All outward function calls get collated into a single inward call, and only the latest (most recent) arguments as passed on to the debounced function.
>
> ##### Options:
>
> `delay: 0` - _The number of milliseconds to buffer calls for._
```js
class Example {
@debounce
foo() {
return this;
}
}
let e = new Example();
// this will only call foo() once:
for (let i=1000; i--) e.foo();
```
---
License
-------
MIT