Class ProcessTaskRunner

Task runner that runs a task as a process or a command inside a shell.

Hierarchy

ProcessTaskRunner

Implements

TaskRunner

Index

Constructors

constructor

Properties

Methods

Constructors

constructor

new ProcessTaskRunner(): ProcessTaskRunner

Returns ProcessTaskRunner

Properties

Protected Readonly logger

logger: ILogger

Protected Readonly rawProcessFactory

rawProcessFactory: RawProcessFactory

Protected Readonly taskFactory

taskFactory: TaskFactory

Protected Readonly taskTerminalProcessFactory

taskTerminalProcessFactory: TaskTerminalProcessFactory

Methods

Protected argumentNeedsQuotes

argumentNeedsQuotes(value: string, shellQuotingOptions: ShellQuotingFunctions): boolean

- Defined in packages/task/src/node/process/process-task-runner.ts:274
This is task specific, to align with VS Code's behavior.

When parsing arguments, VS Code will try to detect if the user already tried to quote things.

See: https://github.com/microsoft/vscode/blob/d363b988e1e58cf49963841c498681cdc6cb55a3/src/vs/workbench/contrib/tasks/browser/terminalTaskSystem.ts#L1101-L1127

Parameters
- value: string
- shellQuotingOptions: ShellQuotingFunctions
Returns boolean

Protected asFsPath

asFsPath(uriOrPath: string): string

- Defined in packages/task/src/node/process/process-task-runner.ts:336
Parameters
- uriOrPath: string
Returns string

Protected executableFileExists

executableFileExists(filePath: string): Promise<boolean>

- Defined in packages/task/src/node/process/process-task-runner.ts:349
deprecated

Remove ProcessTaskRunner.findCommand, introduce process "started" event Checks for the existence of a file, at the provided path, and make sure that it's readable and executable.

Parameters
- filePath: string
Returns Promise<boolean>

Private getCommand

getCommand(processType: ProcessType, terminalProcessOptions: TerminalProcessOptions): undefined | string

- Defined in packages/task/src/node/process/process-task-runner.ts:253
Parameters
- processType: ProcessType
- terminalProcessOptions: TerminalProcessOptions
Returns undefined | string

Private getResolvedCommand

getResolvedCommand(taskConfig: TaskConfiguration): TerminalProcessOptions

- Defined in packages/task/src/node/process/process-task-runner.ts:100
Parameters
- taskConfig: TaskConfiguration
Returns TerminalProcessOptions

Private getSystemSpecificCommand

getSystemSpecificCommand(taskConfig: TaskConfiguration, system: undefined | "windows" | "linux" | "osx"): { args: undefined | (string | ShellQuotedString)[]; command: undefined | string; options: CommandOptions }

- Defined in packages/task/src/node/process/process-task-runner.ts:307
Parameters
- taskConfig: TaskConfiguration
- system: undefined | "windows" | "linux" | "osx"
Returns { args: undefined | (string | ShellQuotedString)[]; command: undefined | string; options: CommandOptions }
- args: undefined | (string | ShellQuotedString)[]
- command: undefined | string
- options: CommandOptions

run

run(taskConfig: TaskConfiguration, ctx?: string): Promise<Task>

Implementation of TaskRunner.run
- Defined in packages/task/src/node/process/process-task-runner.ts:65
Runs a task from the given task configuration.

Parameters
- taskConfig: TaskConfiguration
  
  task configuration to run a task from. The provided task configuration must have a shape of CommandProperties.
- Optional ctx: string
Returns Promise<Task>