Function parseInput

docs/tools/lighthouse-audit.mjs:177–203

* Parse CLI args and throw errors if any are invalid. * the validated URL, parsed minimum scores, and optional file path to write the report to

(args)

 *  the validated URL, parsed minimum scores, and optional file path to write the report to
 */
function parseInput(args) {
  const [url, minScoresRaw] = args;

  if (!url) {
    onError('Invalid arguments: <url> not specified.');
  } else if (!minScoresRaw) {
    onError('Invalid arguments: <min-scores> not specified.');
  }

  const minScores = parseMinScores(minScoresRaw || '');
  const unknownCategories = Object.keys(minScores).filter(cat => !AUDIT_CATEGORIES.includes(cat));
  const allValuesValid = Object.values(minScores).every(x => 0 <= x && x <= 1);

  if (unknownCategories.length > 0) {
    onError(
      `Invalid arguments: <min-scores> contains unknown category(-ies): ${unknownCategories.join(
        ', ',
      )}`,
    );
  } else if (!allValuesValid) {
    onError(
      `Invalid arguments: <min-scores> has non-numeric or out-of-range values: ${minScoresRaw}`,
    );
  }

  return {url, minScores};
}

/**
 * @param {string} raw is either a number (in which case it is interpreted as `all:<min-score>`)