No description, website, or topics provided.
JavaScript
Switch branches/tags
Nothing to show
Latest commit 8a2fda7 Apr 15, 2017 @dominictarr 4.0.0
Permalink
Failed to load latest commit information.
test
.travis.yml
LICENSE
README.md
index.js
package.json

README.md

looper

Loop with callbacks but don't RangeError

travis

testling

Synopsis

Normally, if mightBeAsync calls it's cb immediately this would RangeError:

var l = 100000
;(function next () {
  if(--l) mightBeAsync(next)
})

looper detects that case, and falls back to a while loop, in computer science something like this is called a trampoline this module is simpler than other trampoline libraries such as tail-call because it does not preserve arguments. But this is still useful for looping when async recursion is sometimes sync.

This is about 10 times faster than using setImmediate

Example

var looper = require('looper')

var l = 100000
var next = looper(function () {
  if(--l) probablySync(next)
})

next()

when you want to stop looping, don't call next. looper checks if each callback is sync or not, so you can even mix sync and async calls!

License

MIT