Function error

src/common.js:95–135

(msg, _code, options)

// Shows error message. Throws if fatal is true (defaults to config.fatal, overridable with options.fatal)
function error(msg, _code, options) {
  // Validate input
  if (typeof msg !== 'string') throw new Error('msg must be a string');

  var DEFAULT_OPTIONS = {
    continue: false,
    code: 1,
    prefix: state.currentCmd + ': ',
    silent: false,
    fatal: config.fatal,
  };

  if (typeof _code === 'number' && isObject(options)) {
    options.code = _code;
  } else if (isObject(_code)) { // no 'code'
    options = _code;
  } else if (typeof _code === 'number') { // no 'options'
    options = { code: _code };
  } else if (typeof _code !== 'number') { // only 'msg'
    options = {};
  }
  options = Object.assign({}, DEFAULT_OPTIONS, options);

  if (!state.errorCode) state.errorCode = options.code;

  var logEntry = convertErrorOutput(options.prefix + msg);
  state.error = state.error ? state.error + '\n' : '';
  state.error += logEntry;

  // Throw an error, or log the entry
  if (options.fatal) {
    var err = new Error(logEntry);
    err.code = options.code;
    throw err;
  }
  if (msg.length > 0 && !options.silent) log(logEntry);

  if (!options.continue) {
    throw new CommandError(new ShellString('', state.error, state.errorCode));
  }
}
exports.error = error;

//@