Function scheduleTimeoutWith

Creates and starts a timer which executes a function or specified piece of code once the timer expires. The overrideFn will be used to create the timer, this is simular to using setTimeout but provides a return object for cancelling and restarting (refresh) the timer.

The timer may be cancelled (cleared) by calling the cancel() function on the returned ITimerHandler, or you can "reschedule" and/or "restart" the timer by calling the refresh() function on the returned ITimerHandler instance

Since

0.4.4

Param: overrideFn

setTimeout override function this will be called instead of the setTimeout, if the value of overrideFn is null or undefined it will revert back to the native setTimeout. May also be an array with contains both the setTimeout and clearTimeout override functions, if either is not provided the default native functions will be used

Param: callback

The function to be executed after the timer expires.

Param: timeout

The time, in milliseconds that the timer should wait before the specified function or code is executed. If this parameter is omitted, a value of 0 is used, meaning execute "immediately", or more accurately, the next event cycle.

Param: args

Additional arguments which are passed through to the function specified by callback.

Returns

A ITimerHandler instance which can be used to cancel the timeout.

Example

let timeoutCalled = false;
// Your own "setTimeout" implementation to allow you to perform additional operations or possible wrap
// the callback to add timings.
function newSetTimeoutFn(callback: TimeoutOverrideFn) {
    overrideCalled ++;
    return setTimeout(callback, timeout);
}

let theTimeout = scheduleTimeoutWith(newSetTimeoutFn, () => {
    // This callback will be called after 100ms as this uses setTimeout()
    timeoutCalled = true;
}, 100);

// Instead of calling clearTimeout() with the returned value from setTimeout() the returned
// handler instance can be used instead to cancel the timer
theTimeout.cancel();
theTimeout.enabled;    // false

// You can start the timer via enabled
theTimeout.enabled = true;

// You can also "restart" the timer, whether it has previously triggered not not via the `refresh()`
theTimeout.refresh();

Example

let timeoutCalled = false;
// Your own "setTimeout" implementation to allow you to perform additional operations or possible wrap
// the callback to add timings.
function newSetTimeoutFn(callback: TimeoutOverrideFn) {
    overrideCalled ++;
    return setTimeout(callback, timeout);
}

// Your own "clearTimeout" implementation to allow you to perform additional operations or possible wrap
// the callback to add timings.
function newClearTimeoutFn(timeoutId: number) {
    overrideCalled ++;
    return clearTimeout( timeout);
}

let theTimeout = scheduleTimeoutWith([newSetTimeoutFn, newClearTimeoutFn], () => {
    // This callback will be called after 100ms as this uses setTimeout()
    timeoutCalled = true;
}, 100);

// Instead of calling clearTimeout() with the returned value from setTimeout() the returned
// handler instance can be used instead to cancel the timer, internally this will call the newClearTimeoutFn
theTimeout.cancel();
theTimeout.enabled;    // false

// You can start the timer via enabled
theTimeout.enabled = true;

// You can also "restart" the timer, whether it has previously triggered not not via the `refresh()`
theTimeout.refresh();
  • scheduleTimeoutWith<A>(overrideFn, callback, timeout, ...args): ITimerHandler

  • Creates and starts a timer which executes a function or specified piece of code once the timer expires. The overrideFn will be used to create the timer, this is simular to using setTimeout but provides a return object for cancelling and restarting (refresh) the timer.

    The timer may be cancelled (cleared) by calling the cancel() function on the returned ITimerHandler, or you can "reschedule" and/or "restart" the timer by calling the refresh() function on the returned ITimerHandler instance

    Type Parameters

    • A extends any[]

    Parameters

    • overrideFn: TimeoutOverrideFn | TimeoutOverrideFuncs

      setTimeout override function this will be called instead of the setTimeout, if the value of overrideFn is null or undefined it will revert back to the native setTimeout. May also be an array with contains both the setTimeout and clearTimeout override functions, if either is not provided the default native functions will be used

    • callback: ((...args: A) => void)

      The function to be executed after the timer expires.

        • (...args): void

        • Parameters

          • Rest...args: A

          Returns void

    • timeout: number

      The time, in milliseconds that the timer should wait before the specified function or code is executed. If this parameter is omitted, a value of 0 is used, meaning execute "immediately", or more accurately, the next event cycle.

    • Rest...args: A

      Additional arguments which are passed through to the function specified by callback.

    Returns ITimerHandler

    A ITimerHandler instance which can be used to cancel the timeout.

    Since

    0.4.4

    Example

    let timeoutCalled = false;
    // Your own "setTimeout" implementation to allow you to perform additional operations or possible wrap
    // the callback to add timings.
    function newSetTimeoutFn(callback: TimeoutOverrideFn) {
        overrideCalled ++;
        return setTimeout(callback, timeout);
    }

    let theTimeout = scheduleTimeoutWith(newSetTimeoutFn, () => {
        // This callback will be called after 100ms as this uses setTimeout()
        timeoutCalled = true;
    }, 100);

    // Instead of calling clearTimeout() with the returned value from setTimeout() the returned
    // handler instance can be used instead to cancel the timer
    theTimeout.cancel();
    theTimeout.enabled;    // false

    // You can start the timer via enabled
    theTimeout.enabled = true;

    // You can also "restart" the timer, whether it has previously triggered not not via the `refresh()`
    theTimeout.refresh();

    Example

    let timeoutCalled = false;
    // Your own "setTimeout" implementation to allow you to perform additional operations or possible wrap
    // the callback to add timings.
    function newSetTimeoutFn(callback: TimeoutOverrideFn) {
        overrideCalled ++;
        return setTimeout(callback, timeout);
    }

    // Your own "clearTimeout" implementation to allow you to perform additional operations or possible wrap
    // the callback to add timings.
    function newClearTimeoutFn(timeoutId: number) {
        overrideCalled ++;
        return clearTimeout( timeout);
    }

    let theTimeout = scheduleTimeoutWith([newSetTimeoutFn, newClearTimeoutFn], () => {
        // This callback will be called after 100ms as this uses setTimeout()
        timeoutCalled = true;
    }, 100);

    // Instead of calling clearTimeout() with the returned value from setTimeout() the returned
    // handler instance can be used instead to cancel the timer, internally this will call the newClearTimeoutFn
    theTimeout.cancel();
    theTimeout.enabled;    // false

    // You can start the timer via enabled
    theTimeout.enabled = true;

    // You can also "restart" the timer, whether it has previously triggered not not via the `refresh()`
    theTimeout.refresh();

Settings

Member Visibility