/**
* @class Ext.util.DelayedTask
* Provides a convenient method of performing setTimeout where a new
* timeout cancels the old timeout. An example would be performing validation on a keypress.
* You can use this class to buffer
* the keypress events for a certain number of milliseconds, and perform only if they stop
* for that amount of time.
* @constructor The parameters to this constructor serve as defaults and are not required.
* @param {Function} fn (optional) The default function to timeout
* @param {Object} scope (optional) The default scope of that timeout
* @param {Array} args (optional) The default Array of arguments
*/
Ext.util.DelayedTask = function(fn, scope, args){
var me = this,
NULL = null,
id = NULL,
_delay,
_time,
call = function(){
var now = new Date().getTime();
if(now - _time >= _delay){
clearInterval(id);
id = NULL;
fn.apply(scope, args || []);
}
};
/**
* Cancels any pending timeout and queues a new one
* @param {Number} delay The milliseconds to delay
* @param {Function} newFn (optional) Overrides function passed to constructor
* @param {Object} newScope (optional) Overrides scope passed to constructor
* @param {Array} newArgs (optional) Overrides args passed to constructor
*/
me.delay = function(delay, newFn, newScope, newArgs){
if(id && delay != _delay){
this.cancel();
}
_delay = delay;
_time = new Date().getTime();
fn = newFn || fn;
scope = newScope || scope;
args = newArgs || args;
if(!id){
id = setInterval(call, _delay);
}
};
/**
* Cancel the last queued timeout
*/
me.cancel = function(){
if(id){
clearInterval(id);
id = NULL;
}
};
};