TerminalOptions
Value-object describing what options a terminal should use.
Properties
The icon ThemeColor for the terminal. The terminal.ansi*
theme keys are recommended for the best contrast and consistency across themes.
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. The hidden terminals will not be restored when the workspace is next opened.
Opt-out of the default terminal persistence on restart and reload. This will only take effect when terminal.integrated.enablePersistentSessions
is enabled.
The TerminalLocation or TerminalEditorLocationOptions or TerminalSplitLocationOptions for the terminal.
Args for the custom shell executable. A string can be used on Windows only which allows specifying shell args in command-line format.
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.env.windows
on top. When this is true, the complete environment must be provided as nothing will be inherited from the process or any configuration.