throttle_.throttle(function, wait)
- Returns a throttled version of the function, that, when invoked repeatedly,
- will only actually call the wrapped function at most once per every wait
+ Creates and returns a new, throttled version of the passed function,
+ that, when invoked repeatedly, will only actually call the original function
+ at most once per every wait
milliseconds. Useful for rate-limiting events that occur faster than you
can keep up with.
-
-
- This method returns a function; it does
- not itself execute its first argument. You should call _.throttle
- only once for each function you wish to throttle (not repeatedly!).
- It is the function returned from that once call to _.throttle
- that you should invoke on each occurrance of the event you wish to throttle.
var throttled = _.throttle(updatePosition, 100);
@@ -810,23 +804,13 @@ $(window).scroll(throttled);
debounce_.debounce(function, wait)
- Calling a debounced function will postpone its execution until after
- wait milliseconds have elapsed since the last time the function
+ Creates and returns a new debounced version of the passed function that
+ will postpone its execution until after
+ wait milliseconds have elapsed since the last time it
was invoked. Useful for implementing behavior that should only happen
after the input has stopped arriving. For example: rendering a
preview of a Markdown comment, recalculating a layout after the window
- has stopped being resized, etc.
-
-
- Please note that the first invocation of a debounced function will *not*
- immediately execute it, but rather, the first execution will be at least wait
- milliseconds later.
-
-
- As with throttle, this method returns a function; it does
- not itself execute its first argument. You should call _.debounce
- only once for each function you wish to debounce, and you should
- call the returned function every time the event you wish to debounce occurs.
+ has stopped being resized, and so on.
var lazyLayout = _.debounce(calculateLayout, 300);