@salesforce/command
Options
All
  • Public
  • Public/Protected
  • All
Menu

A base command that provides convenient access to common SFDX flags, a logger, CLI output formatting, scratch orgs, and devhubs. Extend this command and set various static properties and a flag configuration to add SFDX behavior.

extends

@oclif/command

see

https://github.com/oclif/command

Hierarchy

  • Command
    • SfdxCommand

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

  • new SfdxCommand(argv: string[], config: IConfig): SfdxCommand

  • Parameters

    • argv: string[]
    • config: IConfig

    Returns SfdxCommand

Properties

Protected args

args: OutputArgs<any>

argv

argv: string[]

config

config: IConfig

Protected configAggregator

configAggregator: ConfigAggregator

ctor

ctor: Command

Protected debug

debug: function

Type declaration

    • (...args: any[]): void

    • Parameters

      • Rest ...args: any[]

      Returns void

Protected flags

flags: OutputFlags<any>

Protected Optional hubOrg

hubOrg: Org

id

id: string | undefined

Protected logger

logger: Logger

Protected Optional org

org: Org

Protected Optional project

project: SfdxProject

Protected result

result: Result

Protected ux

ux: UX

Protected Optional varargs

varargs: JsonMap

Static _base

_base: string

Static aliases

aliases: string[]

Static Optional args

args: IArg[]

Static description

description: string | undefined

Static examples

examples: string[] | undefined

Static Protected flagsConfig

flagsConfig: FlagsConfig

Static help

help: string | undefined

Static hidden

hidden: boolean

Static id

id: string

Static parse

parse: boolean

Static parserOptions

parserOptions: __type

Static plugin

plugin: IPlugin | undefined

Static Protected requiresDevhubUsername

requiresDevhubUsername: boolean = false

Static Protected requiresProject

requiresProject: boolean = false

Static Protected requiresUsername

requiresUsername: boolean = false

Static Protected result

result: SfdxResult

Static run

run: run

instantiate and run the command

Static strict

strict: boolean

Static Protected supportsDevhubUsername

supportsDevhubUsername: boolean = false

Static Protected supportsUsername

supportsUsername: boolean = false

Static Protected tableColumnData

tableColumnData: string[]

Static title

title: string | undefined

Static usage

usage: string | string[] | undefined

Static Protected varargs

varargs: VarargsConfig = false

Accessors

Protected statics

statics:

Static flags

flags:

Methods

Protected _help

  • _help(): never

  • Returns never

Protected _helpOverride

  • _helpOverride(): boolean

  • Returns boolean

_run

  • _run<T>(): Promise<Optional<T>>

  • Type parameters

    • T

    Returns Promise<Optional<T>>

Protected _version

  • _version(): never

  • Returns never

Protected assignHubOrg

  • assignHubOrg(): Promise<void>

Protected assignOrg

  • assignOrg(): Promise<void>

Protected assignProject

  • assignProject(): Promise<void>

Protected catch

  • catch(err: any): Promise<void>

  • Parameters

    • err: any

    Returns Promise<void>

error

  • error(input: string | Error, options: object): void
  • error(input: string | Error, options?: undefined | object): never

  • Parameters

    • input: string | Error
    • options: object

    Returns void

  • Parameters

    • input: string | Error
    • Optional options: undefined | object

    Returns never

exit

  • exit(code?: undefined | number): never

  • Parameters

    • Optional code: undefined | number

    Returns never

Protected finally

  • finally(err: Optional<Error>): Promise<void>

  • Parameters

    • err: Optional<Error>

    Returns Promise<void>

Protected formatError

  • formatError(error: SfdxError): string[]

  • Format errors and actions for human consumption. Adds 'ERROR running ', and outputs all errors in red. When there are actions, we add 'Try this:' in blue followed by each action in red on its own line.

    Parameters

    • error: SfdxError

    Returns string[]

    Returns decorated messages.

Protected init

  • init(): Promise<void>

log

  • log(message?: undefined | string, ...args: any[]): void

  • Parameters

    • Optional message: undefined | string
    • Rest ...args: any[]

    Returns void

Protected parse

  • parse<F, A>(options?: Parser.Input<F>, argv?: string[]): Parser.Output<F, A>

  • Type parameters

    • F

    • A: object

    Parameters

    • Optional options: Parser.Input<F>
    • Optional argv: string[]

    Returns Parser.Output<F, A>

Protected parseVarargs

  • parseVarargs(args?: string[]): JsonMap

  • Parameters

    • Default value args: string[] = []

    Returns JsonMap

Abstract run

  • run(): Promise<any>

Protected shouldEmitHelp

  • shouldEmitHelp(): boolean

warn

  • warn(input: string | Error): void

  • Parameters

    • input: string | Error

    Returns void