aboutsummaryrefslogtreecommitdiff
path: root/tools/addon-sdk-1.4/packages/addon-kit/docs/timers.md
blob: bc36750f5111f0f46381284ca4b553ccdc1cc98b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<!-- contributed by Drew Willcoxon [adw@mozilla.com]  -->
<!-- contributed by Atul Varma [atul@mozilla.com]  -->
<!-- edited by Noelle Murata [fiveinchpixie@gmail.com]  -->
<!-- contributed by Irakli Gozalishvil [gozala@mozilla.com] -->

The `timers` module provides access to web-like timing functionality.

<api name="setTimeout">
@function
  Schedules `callback` to be called in `ms` milliseconds. Any additional
  arguments are passed straight through to the callback.
@returns {integer}
  An ID that can later be used to undo this scheduling, if `callback` hasn't yet
  been called.
@param callback {function}
  Function to be called.
@param ms {integer}
  Interval in milliseconds after which the function will be called.
</api>

<api name="clearTimeout">
@function
  Given an ID returned from `setTimeout()`, prevents the callback with the ID
  from being called (if it hasn't yet been called).
@param ID {integer}
  An ID returned from `setTimeout()`.
</api>

<api name="setInterval">
@function
  Schedules `callback` to be called repeatedly every `ms` milliseconds. Any
  additional arguments are passed straight through to the callback.
@returns {integer}
  An ID that can later be used to unschedule the callback.
@param callback {function}
  Function to be called.
@param ms {integer}
  Interval in milliseconds at which the function will be called.
</api>

<api name="clearInterval">
@function
  Given an ID returned from `setInterval()`, prevents the callback with the ID
  from being called again.
@param ID {integer}
  An ID returned from `setInterval()`.
</api>