Skip to content

Function: short() ​

Set a short alias on a combinator schema.

The original schema is not modified. Other modifiers on schema (for example multiple) are kept.

Signature ​

ts
export declare function short<T, A extends string, S extends CombinatorSchema<T> = CombinatorSchema<T>>(schema: S, alias: A): Modified<S, CombinatorShort<A>>

Type Parameters ​

NameDescription
TThe schema's parsed type, when type arguments are given explicitly. It is not inferred, so that schema can be a union of schemas of different types.
A extends stringThe short alias string literal type.
S extends CombinatorSchema<T> = CombinatorSchema<T>The input combinator schema, inferred from schema. Its other modifiers are kept. If type arguments are given explicitly without S, S is CombinatorSchema<T>, and the type of the result lacks the other modifiers, although the returned object has them.

Parameters ​

NameTypeDescription
schemaSThe base combinator schema.
aliasASingle character short alias.

Returns ​

Modified<S, CombinatorShort<A>> — A new schema with the short alias set.

Examples ​

ts
const args = {
  verbose: short(boolean(), 'v')
}
// Usage: -v or --verbose

Released under the MIT License.