picklist

Creates a picklist schema.

const Schema = picklist<TOptions>(options, message);

Generics

• TOptions extends PicklistOptions

Parameters

• options TOptions
• message ErrorMessage | undefined

Explanation

With picklist you can validate that the input corresponds to a picklist option. If the input is invalid, you can use message to customize the error message.

picklist works in a similar way to enum_. However, in many cases it is easier to use because you can pass an array of strings instead of an enum.

Returns

• Schema PicklistSchema<TOptions>

Examples

The following examples show how picklist can be used.

Language schema

Schema to validate programming languages.

const LanguageSchema = picklist(['JavaScript', 'TypeScript']);

Country schema

Schema to validate country codes.

const countries = [
  { name: 'Germany', code: 'DE' },
  { name: 'France', code: 'FR' },
  { name: 'United States', code: 'US' },
] as const;

const CountrySchema = picklist(
  countries.map((country) => country.code),
  'Please select your country.'
);

Related

The following APIs can be combined with enum_.

Schemas

• array,
• intersect,
• lazy,
• map,
• nonNullable,
• nonNullish,
• nonOptional,
• nullable,
• nullish,
• object,
• optional,
• record,
• set,
• tuple,
• union

Methods

• brand,
• coerce,
• fallback,
• getDefault,
• getDefaults,
• getFallback,
• getFallbacks,
• is,
• parse,
• safeParse,
• transform