Improve this Doc View Source $interval

From Get docs
< Service components in ngAngularjs/docs/1.8/api/ng/service/$interval

Improve this Doc View Source $interval

  1. service in module ng


AngularJS's wrapper for window.setInterval. The fn function is executed every delay milliseconds.

The return value of registering an interval function is a promise. This promise will be notified upon each tick of the interval, and will be resolved after count iterations, or run indefinitely if count is not defined. The value of the notification will be the number of iterations that have run. To cancel an interval, call $interval.cancel(promise).

In tests you can use $interval.flush(millis) to move forward by millis milliseconds and trigger any functions scheduled to run in that time.

Note: Intervals created by this service must be explicitly destroyed when you are finished with them. In particular they are not automatically destroyed when a controller's scope or a directive's element are destroyed. You should take this into consideration and make sure to always cancel the interval at the appropriate moment. See the example below for more details on how and when to do this.


$interval(fn, delay, [count], [invokeApply], [Pass]);


Param Type Details
fn function() A function that should be called repeatedly. If no additional arguments are passed (see below), the function is called with the current iteration count.
delay number Number of milliseconds between each function call.




Number of times to repeat. If not set, or 0, will repeat indefinitely.

(default: 0)




If set to false skips model dirty checking, otherwise will invoke fn within the $apply block.

(default: true)



* additional parameters to the executed function.


promise A promise which will be notified on each iteration. It will resolve once all iterations of the interval complete.


  • === cancel([promise]); ===

    Cancels a task associated with the promise.


    Param Type Details




    returned by the $interval function.



    Returns true if the task was successfully canceled.


© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.$interval