debian-mirror-gitlab/spec/frontend/lib/utils/dom_utils_spec.js

import { setHTMLFixture, resetHTMLFixture } from 'helpers/fixtures';
import {
  addClassIfElementExists,
  canScrollUp,
  canScrollDown,
  parseBooleanDataAttributes,
  isElementVisible,
  getParents,
  getParentByTagName,
  setAttributes,
} from '~/lib/utils/dom_utils';

const TEST_MARGIN = 5;

describe('DOM Utils', () => {
  describe('addClassIfElementExists', () => {
    const className = 'biology';
    const fixture = `
      <div class="parent">
        <div class="child"></div>
      </div>
    `;

    let parentElement;

    beforeEach(() => {
      setHTMLFixture(fixture);
      parentElement = document.querySelector('.parent');
    });

    afterEach(() => {
      resetHTMLFixture();
    });

    it('adds class if element exists', () => {
      const childElement = parentElement.querySelector('.child');

      expect(childElement).not.toBe(null);

      addClassIfElementExists(childElement, className);

      expect(childElement.classList).toContainEqual(className);
    });

    it('does not throw if element does not exist', () => {
      const childElement = parentElement.querySelector('.other-child');

      expect(childElement).toBe(null);

      addClassIfElementExists(childElement, className);
    });
  });

  describe('canScrollUp', () => {
    [1, 100].forEach((scrollTop) => {
      it(`is true if scrollTop is > 0 (${scrollTop})`, () => {
        expect(
          canScrollUp({
            scrollTop,
          }),
        ).toBe(true);
      });
    });

    [0, -10].forEach((scrollTop) => {
      it(`is false if scrollTop is <= 0 (${scrollTop})`, () => {
        expect(
          canScrollUp({
            scrollTop,
          }),
        ).toBe(false);
      });
    });

    it('is true if scrollTop is > margin', () => {
      expect(
        canScrollUp(
          {
            scrollTop: TEST_MARGIN + 1,
          },
          TEST_MARGIN,
        ),
      ).toBe(true);
    });

    it('is false if scrollTop is <= margin', () => {
      expect(
        canScrollUp(
          {
            scrollTop: TEST_MARGIN,
          },
          TEST_MARGIN,
        ),
      ).toBe(false);
    });
  });

  describe('canScrollDown', () => {
    let element;

    beforeEach(() => {
      element = {
        scrollTop: 7,
        offsetHeight: 22,
        scrollHeight: 30,
      };
    });

    it('is true if element can be scrolled down', () => {
      expect(canScrollDown(element)).toBe(true);
    });

    it('is false if element cannot be scrolled down', () => {
      element.scrollHeight -= 1;

      expect(canScrollDown(element)).toBe(false);
    });

    it('is true if element can be scrolled down, with margin given', () => {
      element.scrollHeight += TEST_MARGIN;

      expect(canScrollDown(element, TEST_MARGIN)).toBe(true);
    });

    it('is false if element cannot be scrolled down, with margin given', () => {
      expect(canScrollDown(element, TEST_MARGIN)).toBe(false);
    });
  });

  describe('parseBooleanDataAttributes', () => {
    let element;

    beforeEach(() => {
      setHTMLFixture('<div data-foo-bar data-baz data-qux="">');
      element = document.querySelector('[data-foo-bar]');
    });

    afterEach(() => {
      resetHTMLFixture();
    });

    it('throws if not given an element', () => {
      expect(() => parseBooleanDataAttributes(null, ['baz'])).toThrow();
    });

    it('throws if not given an array of dataset names', () => {
      expect(() => parseBooleanDataAttributes(element)).toThrow();
    });

    it('returns an empty object if given an empty array of names', () => {
      expect(parseBooleanDataAttributes(element, [])).toEqual({});
    });

    it('correctly parses boolean-like data attributes', () => {
      expect(
        parseBooleanDataAttributes(element, [
          'fooBar',
          'foobar',
          'baz',
          'qux',
          'doesNotExist',
          'toString',
        ]),
      ).toEqual({
        fooBar: true,
        foobar: false,
        baz: true,
        qux: true,
        doesNotExist: false,

        // Ensure prototype properties aren't false positives
        toString: false,
      });
    });
  });

  describe.each`
    offsetWidth | offsetHeight | clientRectsLength | visible
    ${0}        | ${0}         | ${0}              | ${false}
    ${1}        | ${0}         | ${0}              | ${true}
    ${0}        | ${1}         | ${0}              | ${true}
    ${0}        | ${0}         | ${1}              | ${true}
  `('isElementVisible', ({ offsetWidth, offsetHeight, clientRectsLength, visible }) => {
    const element = {
      offsetWidth,
      offsetHeight,
      getClientRects: () => new Array(clientRectsLength),
    };

    const paramDescription = `offsetWidth=${offsetWidth}, offsetHeight=${offsetHeight}, and getClientRects().length=${clientRectsLength}`;

    describe('isElementVisible', () => {
      it(`returns ${visible} when ${paramDescription}`, () => {
        expect(isElementVisible(element)).toBe(visible);
      });
    });
  });

  describe('getParents', () => {
    it('gets all parents of an element', () => {
      const el = document.createElement('div');
      el.innerHTML = '<p><span><strong><mark>hello world';

      expect(getParents(el.querySelector('mark'))).toEqual([
        el.querySelector('strong'),
        el.querySelector('span'),
        el.querySelector('p'),
        el,
      ]);
    });
  });

  describe('getParentByTagName', () => {
    const el = document.createElement('div');
    el.innerHTML = '<p><span><strong><mark>hello world';

    it.each`
      tagName     | parent
      ${'strong'} | ${el.querySelector('strong')}
      ${'span'}   | ${el.querySelector('span')}
      ${'p'}      | ${el.querySelector('p')}
      ${'pre'}    | ${undefined}
    `('gets a parent by tag name', ({ tagName, parent }) => {
      expect(getParentByTagName(el.querySelector('mark'), tagName)).toBe(parent);
    });
  });

  describe('setAttributes', () => {
    it('sets multiple attribues on element', () => {
      const div = document.createElement('div');

      setAttributes(div, { class: 'test', title: 'another test' });

      expect(div.getAttribute('class')).toBe('test');
      expect(div.getAttribute('title')).toBe('another test');
    });
  });
});