Function scheduleInterval

  • scheduleInterval<A>(callback, timeout, ...args): ITimerHandler

  • Repeatedly calls a function or executes a code snippet, with a fixed time delay between each call.

    Type Parameters

    • A extends any[]

    Parameters

    • callback: ((...args) => 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 or refresh the interval.

    Since

    0.4.4

    Example

    let intervalCalled = 0;
    let theIntervalTimer = scheduleInvertal(() => {
        // This callback will be called every 100ms as this uses setInterval()
        intervalCalled++;
    }, 100);

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

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

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

Settings

Member Visibility

Theme