getSocketServerImplementation.js

'use strict';

const validateOptions = require('schema-utils');
const schema = require('../schemas/utils/socketServerImplementationPrototype.json');

function getSocketServerImplementation(options) {
  let ServerImplementation;
  let serverImplFound = true;
  switch (typeof options.serverMode) {
    case 'string':
      // could be 'sockjs', in the future 'ws', or a path that should be required
      if (options.serverMode === 'sockjs') {
        // eslint-disable-next-line global-require
        ServerImplementation = require('../servers/SockJSServer');
      } else {
        try {
          // eslint-disable-next-line global-require, import/no-dynamic-require
          ServerImplementation = require(options.serverMode);
        } catch (e) {
          serverImplFound = false;
        }
      }
      break;
    case 'function':
      // potentially do more checks here to confirm that the user implemented this properlly
      // since errors could be difficult to understand
      ServerImplementation = options.serverMode;
      break;
    default:
      serverImplFound = false;
  }

  if (!serverImplFound) {
    throw new Error(
      "serverMode must be a string denoting a default implementation (e.g. 'sockjs'), a full path to " +
        'a JS file which exports a class extending BaseServer (webpack-dev-server/lib/servers/BaseServer) ' +
        'via require.resolve(...), or the class itself which extends BaseServer'
    );
  }

  validateOptions(schema, ServerImplementation.prototype, 'webpack Dev Server');

  return ServerImplementation;
}

module.exports = getSocketServerImplementation;