Value-object describing what options a terminal should use.
Fields
optionalstrictEnv:Null<Bool>
Whether the terminal process environment should be exactly as provided in
TerminalOptions.env
. When this is false (default), the environment will be based on the
window's environment and also apply configured platform settings like
terminal.integrated.windows.env
on top. When this is true, the complete environment
must be provided as nothing will be inherited from the process or any configuration.
optionalshellArgs:Null<EitherType<Array<String>, String>>
Args for the custom shell executable. A string can be used on Windows only which allows specifying shell args in command-line format.
optionalname:Null<String>
A human-readable string which will be used to represent the terminal in the UI.
optionalmessage:Null<String>
A message to write to the terminal on first launch, note that this is not sent to the process but, rather written directly to the terminal. This supports escape sequences such a setting text style.
optionaliconPath:Null<EitherType<Uri, EitherType<{light:Uri, dark:Uri}, ThemeIcon>>>
The icon path or {@link ThemeIcon} for the terminal.
optionalhideFromUser:Null<Bool>
When enabled the terminal will run the process as normal but not be surfaced to the user
until Terminal.show
is called. The typical usage for this is when you need to run
something that may need interactivity but only want to tell the user about it when
interaction is needed. Note that the terminals will still be exposed to all extensions
as normal.
optionalenv:Null<DynamicAccess<Null<String>>>
Object with environment variables that will be added to the editor process.
optionalcwd:Null<EitherType<String, Uri>>
A path or Uri for the current working directory to be used for the terminal.
optionalcolor:Null<ThemeColor>
The icon {@link ThemeColor} for the terminal.
The terminal.ansi*
theme keys are
recommended for the best contrast and consistency across themes.