Interface SubCommandArgument

Optional list of values that the value must match. This is not supported for ValueTypeName.BOOLEAN.

Optional configuration key to use for the argument. Must consist of alphanumeric non-whitespace uppercase ASCII or _ characters. Must not start with a digit.

If not specified a default configuration key is determined as follows: The SubCommandArgument.name is capitalized and any - characters are replaced with _ characters. If the result starts with a digit, it is prefixed with _. Some examples:

• name: FooBar => configuration key: FOOBAR
• name: Hello-World- => configuration key: HELLO_WORLD_
• name: 3 => configuration key: _3

NOTE: Regardless of whether a configurationKey is specified, or the default is relied upon, it will only be used if the parent Command has specified Command.enableConfiguration as true.

Optional (default is false) for ValueTypeName.STRING when comparing a value against allowableValues.

Optional for ValueTypeName.INTEGER or ValueTypeName.NUMBER when validating a value.

Optional for ValueTypeName.INTEGER or ValueTypeName.NUMBER when validating a value.

Type of the argument value.

Optional custom validation function invoked after all built-in validation has passed. Receives the validated and type-converted value and a ValidationContext giving access to all other provided values of the command. A validator that only needs the value may declare just the first parameter.

Return undefined if the value is valid, or a string describing the validation error. The error string is associated with InvalidArgumentReason.CUSTOM_VALIDATION.

Validators declared on properties nested inside ComplexOption.properties are also invoked, at any depth:

• Validation is bottom-up and depth-first, in properties declaration order. A property's validator is invoked after the validators of its own child properties, and only if they all passed. A parent therefore always receives a fully converted and child-validated value.
• Validation stops at the first failure, so later validators are not invoked.
• For an argument with isArray, the validator is invoked once with the whole converted array. For an array of ComplexOption values, the child property validators are invoked for each element.
• An absent nested property with a defaultValue is validated using the default value. An absent nested property with isOptional and no default is skipped and its validator is not invoked.
• A nested failure is reported with the full property path as the invalid argument name, e.g. opt.sub[2].field.

Example: ensure array values are unique:

validate: (value) => {
  const arr = value as string[];
  return new Set(arr).size !== arr.length
    ? "values must be unique"
    : undefined;
}
Copy