karma.conf.js

// Karma configuration
// Install required modules by running "npm install"

module.exports = function(config) {
  config.set({
    // base path that will be used to resolve all patterns (eg. files, exclude)
    basePath: '.',

    // frameworks to use
    // available frameworks: https://npmjs.org/browse/keyword/karma-adapter
    frameworks: [
      'jasmine-ajax', 'jasmine',
      'sprintf-js',
    ],

    plugins: [
      'karma-*',  // default
      frameworkPluginForModule('sprintf-js'),
    ],

    // list of files / patterns to load in the browser
    files: [
      // closure base first
      'third_party/closure/goog/base.js',

      // deps next
      'dist/deps.js',
      'shaka-player.uncompiled.js',

      // requirejs next
      'node_modules/requirejs/require.js',

      // bootstrapping for the test suite
      'test/test/boot.js',

      // test utils next
      'test/test/util/*.js',

      // list of test assets next
      'demo/assets.js',

      // unit tests last
      'test/**/*_unit.js',

      // if --quick is not present, we will add integration tests.

      // source files - these are only watched and served
      {pattern: 'lib/**/*.js', included: false},
      {pattern: 'third_party/closure/goog/**/*.js', included: false},
      {pattern: 'test/test/assets/*', included: false},
      {pattern: 'dist/shaka-player.compiled.js', included: false},
    ],

    // NOTE: Do not use proxies for media! That sometimes results in truncated
    // content and failed tests. The effect does not appear to be deterministic.
    proxies: {
      '/dist/': '/base/dist/',
    },

    preprocessors: {
      // Don't compute coverage over lib/debug/ or lib/polyfill/
      'lib/!(debug|polyfill)/*.js': 'coverage',
      // Player is not matched by the above, so add it explicitly
      'lib/player.js': 'coverage',
    },

    // to avoid DISCONNECTED messages on Safari:
    browserDisconnectTimeout: 10 * 1000,  // 10s to reconnect
    browserDisconnectTolerance: 1,  // max of 1 disconnect is OK
    browserNoActivityTimeout: 5 * 60 * 1000,  // disconnect after 5m silence
    captureTimeout: 1 * 60 * 1000,  // give up if startup takes 1m
    // https://support.saucelabs.com/customer/en/portal/articles/2440724

    client: {
      // don't capture the client's console logs
      captureConsole: false,
      // |args| must be an array; pass a key-value map as the sole client
      // argument.
      args: [{}],
    },

    // web server port
    port: 9876,

    // enable / disable colors in the output (reporters and logs)
    colors: true,

    // level of logging
    // possible values: config.LOG_DISABLE || config.LOG_ERROR ||
    //                  config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
    logLevel: config.LOG_WARN,

    // do not execute tests whenever any file changes
    autoWatch: false,

    // do a single run of the tests on captured browsers and then quit
    singleRun: true,

    customLaunchers: {
      // These entries are specific to Shaka team's internal test lab:

      // OS X El Capitan {{{
      WebDriver_Safari9: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4445},
        browserName: 'safari',
        pseudoActivityInterval: 20000
      },

      WebDriver_ChromeMac: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4445},
        browserName: 'chrome',
        pseudoActivityInterval: 20000
      },
      // }}}

      // OS X Yosemite {{{
      WebDriver_Safari8: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4444},
        browserName: 'safari',
        pseudoActivityInterval: 20000
      },

      WebDriver_FirefoxMac: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4444},
        browserName: 'firefox',
        pseudoActivityInterval: 20000
      },

      WebDriver_OperaMac: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4444},
        // This is not obvious, but as of 2016-03-17, operadriver responds to
        // browserName 'chrome', not 'opera'.  It still launches opera.  This
        // should be solveable once operachromiumdriver releases sources.
        // See:
        //   https://github.com/operasoftware/operachromiumdriver/issues/8
        //   http://stackoverflow.com/a/27387949
        browserName: 'chrome',
        pseudoActivityInterval: 20000
      },
      // }}}

      // Windows {{{
      WebDriver_IE11: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4446},
        browserName: 'internet explorer',
        pseudoActivityInterval: 20000
      },

      WebDriver_Edge: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4446},
        browserName: 'MicrosoftEdge',
        pseudoActivityInterval: 20000
      },

      WebDriver_ChromeWin: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4446},
        browserName: 'chrome',
        pseudoActivityInterval: 20000
      },

      WebDriver_FirefoxWin: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4446},
        browserName: 'firefox',
        pseudoActivityInterval: 20000
      },
      // }}}

      // Linux {{{
      WebDriver_ChromeLinux: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4447},
        browserName: 'chrome',
        pseudoActivityInterval: 20000
      },

      WebDriver_FirefoxLinux: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4447},
        browserName: 'firefox',
        pseudoActivityInterval: 20000
      },
      // }}}

      // Android 6.0.1 {{{
      // Note this is tethered to the Linux machine.
      WebDriver_ChromeAndroid: {
        base: 'WebDriver',
        config: {hostname: 'localhost', port: 4447},
        browserName: 'chrome',
        pseudoActivityInterval: 20000,
        chromeOptions: {'androidPackage': 'com.android.chrome'}
      },
      // }}}
    },

    coverageReporter: {
      reporters: [
        { type: 'text' },
      ],
    },

    specReporter: {
      suppressSkipped: true,
    },
  });

  if (flagPresent('html-coverage-report')) {
    // Wipe out any old coverage reports to avoid confusion.
    var rimraf = require('rimraf');
    rimraf.sync('coverage', {});  // Like rm -rf

    config.set({
      reporters: [ 'coverage', 'progress' ],
      coverageReporter: {
        reporters: [
          { type: 'html', dir: 'coverage' },
        ],
      },
    });
  }

  if (!flagPresent('quick')) {
    // If --quick is present, we don't serve integration tests.
    var files = config.files;
    files.push('test/**/*_integration.js');
    // We just modified the config in-place.  No need for config.set().
  }

  var logLevel = getFlagValue('enable-logging');
  if (logLevel !== null) {
    if (logLevel === '')
      logLevel = 3;  // INFO

    config.set({
      reporters: ['spec'],
    });
    // Setting |config.client| using config.set will remove the
    // |config.client.args| member.
    config.client.captureConsole = true;
    setClientArg(config, 'logLevel', logLevel);
  }

  if (flagPresent('external')) {
    // Run Player integration tests against external assets.
    // Skipped by default.
    setClientArg(config, 'external', true);
  }

  if (flagPresent('uncompiled')) {
    // Run Player integration tests with uncompiled code for debugging.
    setClientArg(config, 'uncompiled', true);
  }
};

// Sets the value of an argument passed to the client.
function setClientArg(config, name, value) {
  config.client.args[0][name] = value;
}

// Find a custom command-line flag that has a value (e.g. --option=12).
// Returns:
// * string value  --option=12
// * empty string  --option= or --option
// * null          not present
function getFlagValue(name) {
  var re = /^--([^=]+)(?:=(.*))?$/;
  for (var i = 0; i < process.argv.length; i++) {
    var match = re.exec(process.argv[i]);
    if (match && match[1] == name) {
      if (match[2] !== undefined)
        return match[2];
      else
        return '';
    }
  }

  return null;
}

// Find custom command-line flags.
function flagPresent(name) {
  return getFlagValue(name) !== null;
}

// Construct framework plugins on-the-fly for arbitrary node modules.
// A call to this must be placed in the config in the 'plugins' array,
// and the module name must be added to the config in the 'frameworks' array.
function frameworkPluginForModule(name) {
  // The framework injects files into the client which runs the tests.
  var framework = function(files) {
    // Locate the main file for the node module.
    var path = require('path');
    var mainFile = path.resolve(require.resolve(name));

    // Add a file entry to the list of files to be served.
    // This follows the same syntax as above in config.set({files: ...}).
    files.unshift({
      pattern: mainFile, included: true, served: true, watched: false
    });
  };

  // The framework factory function takes one argument, which is the list of
  // files from the karma config.
  framework.$inject = ['config.files'];

  // This is the plugin interface to register a new framework.  Adding this to
  // the list of plugins makes the named module available as a framework.  That
  // framework then injects the module into the client.
  var obj = {};
  obj['framework:' + name] = ['factory', framework];
  return obj;
}