1.5.2 • Published 1 year ago

@antongolub/repeater v1.5.2

Weekly downloads
14
License
MIT
Repository
github
Last release
1 year ago

@antongolub/repeater

Helper for creating auto-calling functions

CI Maintainability Test Coverage npm (tag)

Motivation

The wheel was invented a long time ago: repeat. What's the diff?

  • Repeater stores the last call params and uses them for next invocations.
  • Inherits target's iface.
  • Allows to combine manual and automated calls.

Usage

    import repeater from '@antongolub/repeater'
    
    const target = step => { this.i += step }
    const context = { i: 0 }
    const delay = 1000
    const rep = repeater(target, delay, context)
    
    rep(2)
    
    // Imagine, 5 seconds later new 'manual' call occurs
    setTimeout(() => rep(1), 5000)

    // ~10 seconds after start: 
    setTimeout(() => console.log(context.i), 10000) // 15

Repeater is just a wrapper around the target function. It exposes several util props:

PropDescription
delayinterval in ms
timeoutTimeoutID
targetref for original target function
contextoptional scope
limitoptional remainder of calls
argsarguments of the last invocation

So, anytime you're let to interrupt the repetitive call by clearing timeout:

    clearTimeout(rep.timeout)

Parametrization

    const rep1 = repeater(target, delay, context, limit)
    const rep2 = repeater({target, delay, context, limit})

License

MIT

1.5.2

1 year ago

1.5.1

1 year ago

1.5.0

1 year ago

1.4.1

3 years ago

1.4.0

3 years ago

1.3.0

4 years ago

1.2.1

4 years ago

1.2.0

6 years ago

1.1.2

6 years ago

1.1.1

6 years ago

1.1.0

6 years ago

1.0.4

6 years ago

1.0.3

6 years ago

1.0.2

6 years ago

1.0.1

6 years ago