diff --git a/docs/Timers.md b/docs/Timers.md index b7cfbb8b0..9e652e8cc 100644 --- a/docs/Timers.md +++ b/docs/Timers.md @@ -15,7 +15,7 @@ Timers are an important part of an application and React Native implements the [ - setImmediate, clearImmediate - requestAnimationFrame, cancelAnimationFrame -`requestAnimationFrame(fn)` is the exact equivalent of `setTimeout(fn, 0)`, they are triggered right after the screen has been flushed. +`requestAnimationFrame(fn)` is not the same as `setTimeout(fn, 0)` - the former will fire after all the frame has flushed, whereas the latter will fire as quickly as possible (over 1000x per second on a iPhone 5S). `setImmediate` is executed at the end of the current JavaScript execution block, right before sending the batched response back to native. Note that if you call `setImmediate` within a `setImmediate` callback, it will be executed right away, it won't yield back to native in between.