util.timer API

Prosody provides a system for setting tasks (functions) to run at specified times in the future.


   local timer = require "util.timer";
   timer.add_task(60, function () log("debug", "Hello!") end);
   -- We can now continue, and in 60 seconds from now, the log message "Hello!" will be printed


timer.add_task(delay, function)

Schedules a function to be called after the specified delay, in seconds.

Note that at the time of writing (Prosody 0.4) timers have an accuracy of +/- 1 second.

Repeating timers

If you want to make a repeating timer then you can simply return a number of seconds until you next want the timer to fire.

For the simplest case, if you "return 60" from your callback then the timer will fire again in another 60 seconds.

doc/developers/util/timer.txt · Last modified: 2010/02/18 13:14 by Matthew Wild