Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

std/flags/mod.ts>ParseOptions

Deno standard library
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
interface ParseOptions
import { type ParseOptions } from "https://deno.land/std@0.143.0/flags/mod.ts";

The options for the parse call.

Properties

optional
--: boolean

When true, populate the result _ with everything before the -- and the result ['--'] with everything after the --. Here's an example:

// $ deno run example.ts -- a arg1
import { parse } from "./mod.ts";
console.dir(parse(Deno.args, { "--": false }));
// output: { _: [ "a", "arg1" ] }
console.dir(parse(Deno.args, { "--": true }));
// output: { _: [], --: [ "a", "arg1" ] }

Defaults to false.

optional
alias: Record<string, string | string[]>

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

optional
boolean: boolean | string | 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)

optional
default: Record<string, unknown>

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: string | string[]

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

optional
collect: string | 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 colelcted into one array. If a non-collectable option is used multiple times, the last value is used.

optional
negatable: string | 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.