Skip to main content
Module

std/flags/mod.ts>ParseOptions

Deno standard library
Go to Latest
interface ParseOptions
import { type ParseOptions } from "https://deno.land/std@0.167.0/flags/mod.ts";

The options for the parse call.

Type Parameters

optional
B extends BooleanType = BooleanType
optional
S extends StringType = StringType
optional
C extends Collectable = Collectable
optional
N extends Negatable = Negatable
optional
D extends Record<string, unknown> | undefined = Record<string, unknown> | undefined
optional
A extends Aliases<string, string> | undefined = Aliases<string, string> | undefined
optional
DD extends boolean | undefined = boolean | undefined

Properties

optional
--: DD = false

When true, populate the result _ with everything before the -- and the result ['--'] with everything after the --.

optional
alias: A

An object mapping string names to strings or arrays of string argument names to use as aliases.

optional
boolean: B | ReadonlyArray<Extract<B, string>>

A boolean, string or array of strings to always treat as booleans. If true will treat all double hyphenated arguments without equal signs as boolean (e.g. affects --foo, not -f or --foo=bar). All boolean arguments will be set to false by default.

optional
default: D & Defaults<B, S>

An object mapping string argument names to default values.

optional
stopEarly: boolean

When true, populate the result _ with everything after the first non-option.

optional
string: S | ReadonlyArray<Extract<S, string>>

A string or array of strings argument names to always treat as strings.

optional
collect: C | ReadonlyArray<Extract<C, string>>

A string or array of strings argument names to always treat as arrays. Collectable options can be used multiple times. All values will be collected into one array. If a non-collectable option is used multiple times, the last value is used. All Collectable arguments will be set to [] by default.

optional
negatable: N | ReadonlyArray<Extract<N, string>>

A string or array of strings argument names which can be negated by prefixing them with --no-, like --no-config.

optional
unknown: (
arg: string,
key?: string,
value?: unknown,
) => unknown

A function which is invoked with a command line parameter not defined in the options configuration object. If the function returns false, the unknown option is not added to parsedArgs.