Γρήγορη αναφορά

Οδηγός Yargs (Cheat Sheet)

Γρήγορος οδηγός για τον αναλυτή γραμμής εντολών Yargs στο Node.js: ορίσματα, επιλογές, εντολές, σημαίες και δημιουργία βοήθειας.

· Δημοσιεύτηκε

Το Yargs σάς βοηθά να δημιουργείτε διαδραστικά εργαλεία γραμμής εντολών αναλύοντας ορίσματα και παράγοντας κομψή διεπαφή.

Βασική χρήση

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

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

Έξοδος έκδοσης & βοήθειας

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

Ρύθμιση επιλογών

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

Εντολές & Παραδείγματα

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

Καταμέτρηση & στοίβαξη σημαιών

  .count('verbose')

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

Αυστηρή λειτουργία (Strict Mode)

  .strict()

Προγραμματιστικές μέθοδοι

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

Σχετικά θέματα