JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2021622
  • Score
    100M100P100Q193249F
  • License MIT

Node.js CLI options parser.

Package Exports

  • getopts

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (getopts) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Getopts

Travis CI Codecov npm

Getopts is a Node.js CLI options parser. It's designed according to the Utility Conventions so that your programs behave like typical UNIX utilities effortlessly — without sacrificing developer experience.

Need for speed? Getopts is optimized for runtime performance and runs 10 to 20 times faster than alternatives according to our benchmarks.

Installation

npm i getopts

Usage

Use getopts to parse the arguments passed into your program from the command line.

$ example/demo --super=sonic -au9000 -- game over
const getopts = require("getopts")

const options = getopts(process.argv.slice(2), {
  alias: {
    s: "super",
    u: "ultra"
  },
  default: {
    turbo: true
  }
})

Getopts expects an array of arguments and options object (optional) and returns an object where you can look up the argument keys and their values.

{
  _: ["game", "over"],
  a: true,
  s: "sonic",
  u: "9000",
  super: "sonic",
  ultra: "9000",
  turbo: true
}

API

getopts(argv, options)

argv

An array of arguments to parse. See process.argv.

Arguments that begin with one or two dashes are called options or flags. Options may have one or more aliases. The underscore key stores operands. Operands include non-options, the single dash - and all the arguments after --.

options.alias

An object of option aliases. An alias can be a string or an array of strings.

getopts(["-u"], {
  alias: {
    u: ["U", "ultra"]
  }
}) //=> { _:[], u:true, U:true, ultra:true }

options.boolean

An array of options that should be parsed as booleans. In the example, by indicating that u is a boolean option, the number 1 is parsed as an operand and not as a value.

getopts(["-u", 1], {
  boolean: ["u"]
}) //=> { _:[1], u:true }

options.default

An object of default values for missing options.

getopts(["-u"], {
  default: {
    turbo: true
  }
}) //=> { _:[], u:true, turbo:true }

options.unknown

A function that runs for every unknown option. Return false to dismiss the option.

getopts(["-abc"], {
  unknown: option => "a" === option
}) // => { _:[], a:true }

License

Getopts is MIT licensed. See LICENSE.