Yargs hjälper dig att bygga interaktiva kommandoradsverktyg genom argumenttolkning och generering av hjälptexter.
Grundläggande användning
const argv = require('yargs').argv;
argv._ // Array of positional arguments: [ ... ]
argv.$0 // Executable name: "node bin/mybin"
argv.verbose // Boolean / string flag value: --verbose
Versions- & Hjälputdata
const argv = require('yargs')
// Version configuration
.alias('v', 'version')
.version(function() { return require('../package').version; })
.describe('v', 'show version information')
// Help configuration
.alias('h', 'help')
.help('help')
.usage('Usage: $0 -x [num]')
.showHelpOnFail(false, "Specify --help for available options")
Konfigurering av alternativ
.option('f', {
alias: 'file',
describe: 'Path to target file',
type: 'string', /* 'array' | 'boolean' | 'string' */
nargs: 1,
demand: true,
demand: 'file is required',
default: '/etc/passwd'
// also supports: count: true, requiresArg: true
})
.options({
f: { /* option hash */ }
})
Kommandon & Exempel
.example('$0 -f config.json', 'Run with configuration file')
.epilog('Copyright 2026')
.command('start', 'Start the server application')
Räkning & Stapling av flaggor
.count('verbose')
// Passing -vvv results in:
argv.verbose // => 3
Strikt läge (Strict Mode)
.strict()
Programmatiska metoder
yargs.showHelp()
const helpText = yargs.help() // => string output