postcss-px-to-viewport/spec/px-to-viewport.spec.js

// Jasmine unit tests
// To run tests, run these commands from the project root:
// 1. `npm install -g jasmine-node`
// 2. `jasmine-node spec`

/* global describe, it, expect */

'use strict';
var postcss = require('postcss');
var pxToViewport = require('..');
var basicCSS = '.rule { font-size: 15px }';
var { filterPropList } = require('../src/prop-list-matcher');

describe('px-to-viewport', function() {
  it('should work on the readme example', function () {
    var input = 'h1 { margin: 0 0 20px; font-size: 32px; line-height: 2; letter-spacing: 1px; }';
    var output = 'h1 { margin: 0 0 6.25vw; font-size: 10vw; line-height: 2; letter-spacing: 1px; }';
    var processed = postcss(pxToViewport()).process(input).css;

    expect(processed).toBe(output);
  });

  it('should replace the px unit with vw', function () {
    var processed = postcss(pxToViewport()).process(basicCSS).css;
    var expected = '.rule { font-size: 4.6875vw }';

    expect(processed).toBe(expected);
  });

  it('should handle < 1 values and values without a leading 0', function () {
    var rules = '.rule { margin: 0.5rem .5px -0.2px -.2em }';
    var expected = '.rule { margin: 0.5rem 0.15625vw -0.0625vw -.2em }';
    var options = {
        minPixelValue: 0
    };
    var processed = postcss(pxToViewport(options)).process(rules).css;

    expect(processed).toBe(expected);
  });

  it('should remain unitless if 0', function () {
    var expected = '.rule { font-size: 0px; font-size: 0; }';
    var processed = postcss(pxToViewport()).process(expected).css;

    expect(processed).toBe(expected);
  });

  it('should not add properties that already exist', function () {
      var expected = '.rule { font-size: 16px; font-size: 5vw; }';
      var processed = postcss(pxToViewport()).process(expected).css;

      expect(processed).toBe(expected);
  });
});

describe('value parsing', function() {
  it('should not replace values in double quotes or single quotes', function () {
    var options = {
        propList: ['*']
    };
    var rules = '.rule { content: \'16px\'; font-family: "16px"; font-size: 16px; }';
    var expected = '.rule { content: \'16px\'; font-family: "16px"; font-size: 5vw; }';
    var processed = postcss(pxToViewport(options)).process(rules).css;

    expect(processed).toBe(expected);
  });

  it('should not replace values in `url()`', function () {
    var rules = '.rule { background: url(16px.jpg); font-size: 16px; }';
    var expected = '.rule { background: url(16px.jpg); font-size: 5vw; }';
    var processed = postcss(pxToViewport()).process(rules).css;

    expect(processed).toBe(expected);
  });

  it('should not replace values with an uppercase P or X', function () {
    var rules = '.rule { margin: 12px calc(100% - 14PX); height: calc(100% - 20px); font-size: 12Px; line-height: 16px; }';
    var expected = '.rule { margin: 3.75vw calc(100% - 14PX); height: calc(100% - 6.25vw); font-size: 12Px; line-height: 5vw; }';
    var processed = postcss(pxToViewport()).process(rules).css;

    expect(processed).toBe(expected);
  });
});

describe('unitToConvert', function() {
  it('should ignore non px values by default', function () {
    var expected = '.rule { font-size: 2em }';
    var processed = postcss(pxToViewport()).process(expected).css;

    expect(processed).toBe(expected);
  });

  it('should convert only values described in options', function () {
    var rules = '.rule { font-size: 5em; line-height: 2px }';
    var expected = '.rule { font-size: 1.5625vw; line-height: 2px }';
    var options = {
      unitToConvert: 'em'
    };
    var processed = postcss(pxToViewport(options)).process(rules).css;

    expect(processed).toBe(expected);
  });
});

describe('viewportWidth', function() {
  it('should should replace using 320px by default', function() {
    var expected = '.rule { font-size: 4.6875vw }';
    var processed = postcss(pxToViewport()).process(basicCSS).css;

    expect(processed).toBe(expected);
  });

  it('should replace using viewportWidth from options', function() {
    var expected = '.rule { font-size: 3.125vw }';
    var options = {
      viewportWidth: 480
    }
    var processed = postcss(pxToViewport(options)).process(basicCSS).css;

    expect(processed).toBe(expected);
  })
});

describe('unitPrecision', function () {
  it('should replace using a decimal of 2 places', function () {
      var expected = '.rule { font-size: 4.69vw }';
      var options = {
          unitPrecision: 2
      };
      var processed = postcss(pxToViewport(options)).process(basicCSS).css;

      expect(processed).toBe(expected);
  });
});

describe('viewportUnit', function() {
  it('should replace using unit from options', function() {
    var rules = '.rule { margin-top: 15px }';
    var expected = '.rule { margin-top: 4.6875vh }';
    var options = {
        viewportUnit: 'vh'
    };
    var processed = postcss(pxToViewport(options)).process(rules).css;

    expect(processed).toBe(expected);
  });
});

describe('fontViewportUnit', function() {
  it('should replace only font-size using unit from options', function() {
    var rules = '.rule { margin-top: 15px; font-size: 8px; }';
    var expected = '.rule { margin-top: 4.6875vw; font-size: 2.5vmax; }';
    var options = {
      fontViewportUnit: 'vmax'
    };
    var processed = postcss(pxToViewport(options)).process(rules).css;

    expect(processed).toBe(expected);
  });
});

describe('selectorBlackList', function () {
  it('should ignore selectors in the selector black list', function () {
      var rules = '.rule { font-size: 15px } .rule2 { font-size: 15px }';
      var expected = '.rule { font-size: 4.6875vw } .rule2 { font-size: 15px }';
      var options = {
          selectorBlackList: ['.rule2']
      };
      var processed = postcss(pxToViewport(options)).process(rules).css;

      expect(processed).toBe(expected);
  });

  it('should ignore every selector with `body$`', function () {
      var rules = 'body { font-size: 16px; } .class-body$ { font-size: 16px; } .simple-class { font-size: 16px; }';
      var expected = 'body { font-size: 5vw; } .class-body$ { font-size: 16px; } .simple-class { font-size: 5vw; }';
      var options = {
          selectorBlackList: ['body$']
      };
      var processed = postcss(pxToViewport(options)).process(rules).css;

      expect(processed).toBe(expected);
  });

  it('should only ignore exactly `body`', function () {
      var rules = 'body { font-size: 16px; } .class-body { font-size: 16px; } .simple-class { font-size: 16px; }';
      var expected = 'body { font-size: 16px; } .class-body { font-size: 5vw; } .simple-class { font-size: 5vw; }';
      var options = {
          selectorBlackList: [/^body$/]
      };
      var processed = postcss(pxToViewport(options)).process(rules).css;

      expect(processed).toBe(expected);
  });
});

describe('mediaQuery', function () {
  it('should replace px in media queries', function () {
      var options = {
          mediaQuery: true
      };
      var processed = postcss(pxToViewport(options)).process('@media (min-width: 500px) { .rule { font-size: 16px } }').css;
      var expected = '@media (min-width: 156.25vw) { .rule { font-size: 5vw } }';

      expect(processed).toBe(expected);
  });
});

describe('propList', function () {
  it('should only replace properties in the prop list', function () {
      var css = '.rule { font-size: 16px; margin: 16px; margin-left: 5px; padding: 5px; padding-right: 16px }';
      var expected = '.rule { font-size: 5vw; margin: 5vw; margin-left: 5px; padding: 5px; padding-right: 5vw }';
      var options = {
          propList: ['*font*', 'margin*', '!margin-left', '*-right', 'pad']
      };
      var processed = postcss(pxToViewport(options)).process(css).css;

      expect(processed).toBe(expected);
  });

  it('should only replace properties in the prop list with wildcard', function () {
      var css = '.rule { font-size: 16px; margin: 16px; margin-left: 5px; padding: 5px; padding-right: 16px }';
      var expected = '.rule { font-size: 16px; margin: 5vw; margin-left: 5px; padding: 5px; padding-right: 16px }';
      var options = {
          propList: ['*', '!margin-left', '!*padding*', '!font*']
      };
      var processed = postcss(pxToViewport(options)).process(css).css;

      expect(processed).toBe(expected);
  });

  it('should replace all properties when prop list is not given', function () {
      var rules = '.rule { margin: 16px; font-size: 15px }';
      var expected = '.rule { margin: 5vw; font-size: 4.6875vw }';
      var processed = postcss(pxToViewport()).process(rules).css;

      expect(processed).toBe(expected);
  });
});

describe('minPixelValue', function () {
  it('should not replace values below minPixelValue', function () {
      var options = {
          propWhiteList: [],
          minPixelValue: 2
      };
      var rules = '.rule { border: 1px solid #000; font-size: 16px; margin: 1px 10px; }';
      var expected = '.rule { border: 1px solid #000; font-size: 5vw; margin: 1px 3.125vw; }';
      var processed = postcss(pxToViewport(options)).process(rules).css;

      expect(processed).toBe(expected);
  });
});

describe('exclude', function () {
  var rules = '.rule { border: 1px solid #000; font-size: 16px; margin: 1px 10px; }';
  var covered = '.rule { border: 1px solid #000; font-size: 5vw; margin: 1px 3.125vw; }'
  it('when using regex at the time, the style should not be overwritten.', function () {
    var options = {
      exclude: /node_modules/
    }
    var processed = postcss(pxToViewport(options)).process(rules, {
      from: '/node_modules/main.css'
    }).css;

    expect(processed).toBe(rules);
  });

  it('when using regex at the time, the style should be overwritten.', function () {
    var options = {
      exclude: /node_modules/
    }
    var processed = postcss(pxToViewport(options)).process(rules, {
      from: '/example/main.css'
    }).css;

    expect(processed).toBe(covered);
  });

  it('when using array at the time, the style should not be overwritten.', function () {
    var options = {
      exclude: [/node_modules/, /exclude/]
    }
    var processed = postcss(pxToViewport(options)).process(rules, {
      from: '/exclude/main.css'
    }).css;

    expect(processed).toBe(rules);
  });

  it('when using array at the time, the style should be overwritten.', function () {
    var options = {
      exclude: [/node_modules/, /exclude/]
    }
    var processed = postcss(pxToViewport(options)).process(rules, {
      from: '/example/main.css'
    }).css;

    expect(processed).toBe(covered);
  });
});

describe('replace', function () {
  it('should leave fallback pixel unit with root em value', function () {
    var options = {
      replace: false
    };
    var processed = postcss(pxToViewport(options)).process(basicCSS).css;
    var expected = '.rule { font-size: 15px; font-size: 4.6875vw }';

    expect(processed).toBe(expected);
  });
});

describe('filter-prop-list', function () {
  it('should find "exact" matches from propList', function () {
    var propList = ['font-size', 'margin', '!padding', '*border*', '*', '*y', '!*font*'];
    var expected = 'font-size,margin';
    expect(filterPropList.exact(propList).join()).toBe(expected);
  });

  it('should find "contain" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', '*border*', '*', '*y', '!*font*'];
    var expected = 'margin,border';
    expect(filterPropList.contain(propList).join()).toBe(expected);
  });

  it('should find "start" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', 'border*', '*', '*y', '!*font*'];
    var expected = 'border';
    expect(filterPropList.startWith(propList).join()).toBe(expected);
  });

  it('should find "end" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', 'border*', '*', '*y', '!*font*'];
    var expected = 'y';
    expect(filterPropList.endWith(propList).join()).toBe(expected);
  });

  it('should find "not" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', 'border*', '*', '*y', '!*font*'];
    var expected = 'padding';
    expect(filterPropList.notExact(propList).join()).toBe(expected);
  });

  it('should find "not contain" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', '!border*', '*', '*y', '!*font*'];
    var expected = 'font';
    expect(filterPropList.notContain(propList).join()).toBe(expected);
  });

  it('should find "not start" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', '!border*', '*', '*y', '!*font*'];
    var expected = 'border';
    expect(filterPropList.notStartWith(propList).join()).toBe(expected);
  });

  it('should find "not end" matches from propList and reduce to string', function () {
    var propList = ['font-size', '*margin*', '!padding', '!border*', '*', '!*y', '!*font*'];
    var expected = 'y';
    expect(filterPropList.notEndWith(propList).join()).toBe(expected);
  });
});