Fișă de referință Yargs

Yargs te ajută să construiești instrumente CLI interactive prin parsarea argumentelor și generarea unei interfețe elegante.

Utilizare de bază

const argv = require('yargs').argv;

argv._         // Array of positional arguments: [ ... ]
argv.$0        // Executable name: "node bin/mybin"
argv.verbose   // Boolean / string flag value: --verbose

Afișare versiune și ajutor

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")

Configurarea opțiunilor

  .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 */ }
  })

Comenzi și exemple

  .example('$0 -f config.json', 'Run with configuration file')
  .epilog('Copyright 2026')
  .command('start', 'Start the server application')

Numărare și acumulare flaguri

  .count('verbose')

// Passing -vvv results in:
argv.verbose // => 3

Mod strict (Strict Mode)

  .strict()

Metode programatice

yargs.showHelp()
const helpText = yargs.help() // => string output