gitlab-org--gitlab-foss/spec/javascripts/smart_interval_spec.js

import $ from 'jquery';
import _ from 'underscore';
import SmartInterval from '~/smart_interval';

describe('SmartInterval', function () {
  const DEFAULT_MAX_INTERVAL = 100;
  const DEFAULT_STARTING_INTERVAL = 5;
  const DEFAULT_SHORT_TIMEOUT = 75;
  const DEFAULT_LONG_TIMEOUT = 1000;
  const DEFAULT_INCREMENT_FACTOR = 2;

  function createDefaultSmartInterval(config) {
    const defaultParams = {
      callback: () => Promise.resolve(),
      startingInterval: DEFAULT_STARTING_INTERVAL,
      maxInterval: DEFAULT_MAX_INTERVAL,
      incrementByFactorOf: DEFAULT_INCREMENT_FACTOR,
      lazyStart: false,
      immediateExecution: false,
      hiddenInterval: null,
    };

    if (config) {
      _.extend(defaultParams, config);
    }

    return new SmartInterval(defaultParams);
  }

  describe('Increment Interval', function () {
    beforeEach(function () {
      this.smartInterval = createDefaultSmartInterval();
    });

    it('should increment the interval delay', function (done) {
      const interval = this.smartInterval;
      setTimeout(() => {
        const intervalConfig = this.smartInterval.cfg;
        const iterationCount = 4;
        const maxIntervalAfterIterations = intervalConfig.startingInterval *
          (intervalConfig.incrementByFactorOf ** (iterationCount - 1)); // 40
        const currentInterval = interval.getCurrentInterval();

        // Provide some flexibility for performance of testing environment
        expect(currentInterval).toBeGreaterThan(intervalConfig.startingInterval);
        expect(currentInterval <= maxIntervalAfterIterations).toBeTruthy();

        done();
      }, DEFAULT_SHORT_TIMEOUT); // 4 iterations, increment by 2x = (5 + 10 + 20 + 40)
    });

    it('should not increment past maxInterval', function (done) {
      const interval = this.smartInterval;

      setTimeout(() => {
        const currentInterval = interval.getCurrentInterval();
        expect(currentInterval).toBe(interval.cfg.maxInterval);

        done();
      }, DEFAULT_LONG_TIMEOUT);
    });

    it('does not increment while waiting for callback', function () {
      jasmine.clock().install();

      const smartInterval = createDefaultSmartInterval({
        callback: () => new Promise($.noop),
      });

      jasmine.clock().tick(DEFAULT_SHORT_TIMEOUT);

      const oneInterval = smartInterval.cfg.startingInterval * DEFAULT_INCREMENT_FACTOR;
      expect(smartInterval.getCurrentInterval()).toEqual(oneInterval);

      jasmine.clock().uninstall();
    });
  });

  describe('Public methods', function () {
    beforeEach(function () {
      this.smartInterval = createDefaultSmartInterval();
    });

    it('should cancel an interval', function (done) {
      const interval = this.smartInterval;

      setTimeout(() => {
        interval.cancel();

        const intervalId = interval.state.intervalId;
        const currentInterval = interval.getCurrentInterval();
        const intervalLowerLimit = interval.cfg.startingInterval;

        expect(intervalId).toBeUndefined();
        expect(currentInterval).toBe(intervalLowerLimit);

        done();
      }, DEFAULT_SHORT_TIMEOUT);
    });

    it('should resume an interval', function (done) {
      const interval = this.smartInterval;

      setTimeout(() => {
        interval.cancel();

        interval.resume();

        const intervalId = interval.state.intervalId;

        expect(intervalId).toBeTruthy();

        done();
      }, DEFAULT_SHORT_TIMEOUT);
    });
  });

  describe('DOM Events', function () {
    beforeEach(function () {
      // This ensures DOM and DOM events are initialized for these specs.
      setFixtures('<div></div>');

      this.smartInterval = createDefaultSmartInterval();
    });

    it('should pause when page is not visible', function (done) {
      const interval = this.smartInterval;

      setTimeout(() => {
        expect(interval.state.intervalId).toBeTruthy();

        // simulates triggering of visibilitychange event
        interval.handleVisibilityChange({ target: { visibilityState: 'hidden' } });

        expect(interval.state.intervalId).toBeUndefined();
        done();
      }, DEFAULT_SHORT_TIMEOUT);
    });

    it('should change to the hidden interval when page is not visible', function (done) {
      const HIDDEN_INTERVAL = 1500;
      const interval = createDefaultSmartInterval({ hiddenInterval: HIDDEN_INTERVAL });

      setTimeout(() => {
        expect(interval.state.intervalId).toBeTruthy();
        expect(interval.getCurrentInterval() >= DEFAULT_STARTING_INTERVAL &&
          interval.getCurrentInterval() <= DEFAULT_MAX_INTERVAL).toBeTruthy();

        // simulates triggering of visibilitychange event
        interval.handleVisibilityChange({ target: { visibilityState: 'hidden' } });

        expect(interval.state.intervalId).toBeTruthy();
        expect(interval.getCurrentInterval()).toBe(HIDDEN_INTERVAL);
        done();
      }, DEFAULT_SHORT_TIMEOUT);
    });

    it('should resume when page is becomes visible at the previous interval', function (done) {
      const interval = this.smartInterval;

      setTimeout(() => {
        expect(interval.state.intervalId).toBeTruthy();

        // simulates triggering of visibilitychange event
        interval.handleVisibilityChange({ target: { visibilityState: 'hidden' } });

        expect(interval.state.intervalId).toBeUndefined();

        // simulates triggering of visibilitychange event
        interval.handleVisibilityChange({ target: { visibilityState: 'visible' } });

        expect(interval.state.intervalId).toBeTruthy();

        done();
      }, DEFAULT_SHORT_TIMEOUT);
    });

    it('should cancel on page unload', function (done) {
      const interval = this.smartInterval;

      setTimeout(() => {
        $(document).triggerHandler('beforeunload');
        expect(interval.state.intervalId).toBeUndefined();
        expect(interval.getCurrentInterval()).toBe(interval.cfg.startingInterval);
        done();
      }, DEFAULT_SHORT_TIMEOUT);
    });

    it('should execute callback before first interval', function () {
      const interval = createDefaultSmartInterval({ immediateExecution: true });
      expect(interval.cfg.immediateExecution).toBeFalsy();
    });
  });
});