Skip to content

Latest commit

 

History

History
88 lines (60 loc) · 2.15 KB

deprecated.md

File metadata and controls

88 lines (60 loc) · 2.15 KB

Deprecated

These features are deprecated, which means they may go away in a future major version of Commander. They are currently still available for backwards compatibility, but should not be used in new code.

RegExp .option() parameter

The .option() method allowed a RegExp as the third parameter to restrict what values were accepted.

program.option('-c,--coffee <type>', 'coffee', /short-white|long-black/);

Removed from README in Commander v3. Deprecated from Commander v7.

The newer functionality is the Option .choices() method, or using a custom option processing function.

noHelp

This was an option passed to .command() to hide the command from the built-in help:

program.command('example', 'examnple command', { noHelp: true });

The option was renamed hidden in Commander v5.1. Deprecated from Commander v7.

Default import of global Command object

The default import was a global Command object.

const program = require('commander');

The global Command object is exported as program from Commander v5, or import the Command object.

const { program } = require('commander');
// or
const { Command } = require('commander');
comnst program = new Command()

Removed from README in Commander v5. Deprecated from Commander v7.

Callback to .help() and .outputHelp()

These routines allowed a callback parameter to process the built-in help before display.

program.outputHelp((text) => {
  return colors.red(text);
});

The newer approach is to directly access the built-in help text using .helpInformation().

console.error(colors.red(program.helpInformation()));

Deprecated from Commander v7.

.on('--help')

This was the way to add custom help after the built-in help. From Commander v3.0.0 this used the custom long help option flags, if changed.

program.on('--help', function() {
  console.log('')
  console.log('Examples:');
  console.log('  $ custom-help --help');
  console.log('  $ custom-help -h');
});

The replacement is .addHelpText():

program.addHelpText('after', `
Examples:
  $ custom-help --help
  $ custom-help -h`
);

Deprecated from Commander v7.