VDL Plugin SDK

getOptionEnum

Import from @varavel/vdl-plugin-sdk/utils/options.

function getOptionEnum<T>(
   options, 
   key, 
   allowedValues, 
   defaultValue
): T;

Returns a string option constrained to a known set of allowed values.

Missing, blank, and unsupported values fall back to the provided default.

Type Parameters

Type Parameter
T extends string

Parameters

ParameterTypeDescription
optionsRecord<string, string> | undefinedPlugin options record.
keystringOption name to read.
allowedValuesreadonly T[]Supported string values for the option.
defaultValueTValue returned when the option is missing or invalid.

Returns

T

A valid enum-like string from allowedValues.

Example

getOptionEnum({ format: "esm" }, "format", ["cjs", "esm"] as const, "cjs");
// returns "esm"