setTimeout(fn, 0) running before setImmediate

[kesla]

Running

setTimeout(function() {
  console.log('setTimeout')
}, 0)

setImmediate(function() {
  console.log('setImmediate')
})

will result in

setTimeout
setImmediate

even though the current docs state that "To schedule the "immediate" execution of callback after I/O events callbacks and before setTimeout and setInterval." (http://nodejs.org/docs/latest/api/all.html#all_setimmediate_callback_arg)

Are the docs unclear or is this a real bug?

cc @trevnorris

[kesla]

Also, related to #5943 and #5950

[bnoordhuis]

the current docs state that "To schedule the "immediate" execution of callback after I/O events callbacks and before setTimeout and setInterval."

Documentation bug (but a small one).

The event loop cycle is timers -> I/O -> immediates, rinse and repeat. The documentation is correct but incomplete: it doesn't mention that when you haven't entered the event loop yet (as is the case in your example), then timers come first - but only on the first tick. (In master. To complicate matters, things work slightly less deterministic in v0.10.)

If you wrap your example in another timer, it always prints setImmediate followed by setTimeout.

setTimeout(function() {
  setTimeout(function() {
    console.log('setTimeout')
  }, 0);
  setImmediate(function() {
    console.log('setImmediate')
  });
}, 10);

[willkan]

@bnoordhuis Would you explain the event loop cycle more explicitly?

When have entered event loop, what's the priority of timers, I/O and immediates?

In your code above

setTimeout(function() {
  setTimeout(function() {
    console.log('setTimeout')
  }, 0);
  setImmediate(function() {
    console.log('setImmediate')
  });
}, 10);

Follow the cycle you mentioned above:

timers -> I/O -> immediates

The code will be executed like this:

• run the code :set the wrapper timer
• after 10ms, enter the first event loop
• run the callback of the wrapper timer
  • set the inner timer
  • set the immediate
• enter next event loop
• run the callback of the inner timer
• run the callback of the immediate

Result should be

setTimeout
setImmediate

But actually, result is

setImmediate
setTimeout

Would you tell me where is the place I misunderstanding? Thanks.

[rlidwka]

Disclaimer: image was created at least a year ago, and I have no idea who the original author is

[yorkie]

+1 good graph, thx @rlidwka

[Mithgol]

If on the above graph setTimeout runs on step 2 and setImmediate runs on step 6, then how can the latter precede the former as @willkan said?

[tjfontaine]

timers are based on a time in the future, even if it's 0, while check immediate is always on the next turn of the loop. So it's possible that the delay of the event loop is low enough for the timer to fire after the immediate.

You shouldn't necessarily be concerned about the order of operations in this regard though in my estimation.

[trevnorris]

One correction. process.nextTick() can and will only run after another callback has run. So where it has process.nextTick() on 3, that should be attached to the setTimeout()/setInterval() above.

[tjfontaine]

re #5950

[willkan]

So it's possible that the delay of the event loop is low enough for the timer to fire after the immediate.

I think this is the best answer to my question. Thank you, @tjfontaine
And thanks to @rlidwka 's graph, good explanation!

[rlidwka]

And thanks to @rlidwka 's graph, good explanation!

You're welcome. You might also want to thank a real author of that image, though I have no idea who he is. :-)

[mrhooray]

Thanks @rlidwka, but the image is broken. Could you still find the graph?

[rlidwka]

@mrhooray , http://dailyjs.com/2013/03/11/node-stable/

[mrhooray]

Thanks, @rlidwka!