A collection of mutations that an extension can apply to a process environment. Applies to all scopes.
A collection of mutations that an extension can apply to a process environment. Applies to all scopes.
(append global-environment-variable-collection variable value)
(append global-environment-variable-collection variable value options)
Append a value to an environment variable.
Note that an extension can only make a single change to any one variable, so this will overwrite any previous calls to replace, append or prepend.
Parameters:
variable
: string
- The variable to append to.value
: string
- The value to append to the variable.options
: EnvironmentVariableMutatorOptions | undefined
- Options applied to the mutator, when no options are provided this will
default to { applyAtProcessCreation: true }
.Returns: void
Append a value to an environment variable. Note that an extension can only make a single change to any one variable, so this will overwrite any previous calls to replace, append or prepend. **Parameters:** - `variable`: `string` - The variable to append to. - `value`: `string` - The value to append to the variable. - `options`: `EnvironmentVariableMutatorOptions | undefined` - Options applied to the mutator, when no options are provided this will default to `{ applyAtProcessCreation: true }`. **Returns:** `void`
(clear global-environment-variable-collection)
Clears all mutators from this collection.
Returns: void
Clears all mutators from this collection. **Returns:** `void`
(delete global-environment-variable-collection variable)
Deletes this collection's mutator for a variable.
Parameters:
variable
: string
- The variable to delete the mutator for.Returns: void
Deletes this collection's mutator for a variable. **Parameters:** - `variable`: `string` - The variable to delete the mutator for. **Returns:** `void`
(description global-environment-variable-collection)
A description for the environment variable collection, this will be used to describe the changes in the UI.
A description for the environment variable collection, this will be used to describe the changes in the UI.
(for-each global-environment-variable-collection callback)
(for-each global-environment-variable-collection callback this-arg)
Iterate over each mutator in this collection.
Parameters:
callback
: (variable: string, mutator: EnvironmentVariableMutator, collection: EnvironmentVariableCollection) => any
- Function to execute for each entry.this-arg
: any
- The this
context used when invoking the handler function.Returns: void
Iterate over each mutator in this collection. **Parameters:** - `callback`: `(variable: string, mutator: EnvironmentVariableMutator, collection: EnvironmentVariableCollection) => any` - Function to execute for each entry. - `this-arg`: `any` - The `this` context used when invoking the handler function. **Returns:** `void`
(get global-environment-variable-collection variable)
Gets the mutator that this collection applies to a variable, if any.
Parameters:
variable
: string
- The variable to get the mutator for.Returns: EnvironmentVariableMutator | undefined
Gets the mutator that this collection applies to a variable, if any. **Parameters:** - `variable`: `string` - The variable to get the mutator for. **Returns:** `EnvironmentVariableMutator | undefined`
(persistent? global-environment-variable-collection)
Whether the collection should be cached for the workspace and applied to the terminal across window reloads. When true the collection will be active immediately such when the window reloads. Additionally, this API will return the cached version if it exists. The collection will be invalidated when the extension is uninstalled or when the collection is cleared. Defaults to true.
Whether the collection should be cached for the workspace and applied to the terminal across window reloads. When true the collection will be active immediately such when the window reloads. Additionally, this API will return the cached version if it exists. The collection will be invalidated when the extension is uninstalled or when the collection is cleared. Defaults to true.
(prepend global-environment-variable-collection variable value)
(prepend global-environment-variable-collection variable value options)
Prepend a value to an environment variable.
Note that an extension can only make a single change to any one variable, so this will overwrite any previous calls to replace, append or prepend.
Parameters:
variable
: string
- The variable to prepend.value
: string
- The value to prepend to the variable.options
: EnvironmentVariableMutatorOptions | undefined
- Options applied to the mutator, when no options are provided this will
default to { applyAtProcessCreation: true }
.Returns: void
Prepend a value to an environment variable. Note that an extension can only make a single change to any one variable, so this will overwrite any previous calls to replace, append or prepend. **Parameters:** - `variable`: `string` - The variable to prepend. - `value`: `string` - The value to prepend to the variable. - `options`: `EnvironmentVariableMutatorOptions | undefined` - Options applied to the mutator, when no options are provided this will default to `{ applyAtProcessCreation: true }`. **Returns:** `void`
(replace global-environment-variable-collection variable value)
(replace global-environment-variable-collection variable value options)
Replace an environment variable with a value.
Note that an extension can only make a single change to any one variable, so this will overwrite any previous calls to replace, append or prepend.
Parameters:
variable
: string
- The variable to replace.value
: string
- The value to replace the variable with.options
: EnvironmentVariableMutatorOptions | undefined
- Options applied to the mutator, when no options are provided this will
default to { applyAtProcessCreation: true }
.Returns: void
Replace an environment variable with a value. Note that an extension can only make a single change to any one variable, so this will overwrite any previous calls to replace, append or prepend. **Parameters:** - `variable`: `string` - The variable to replace. - `value`: `string` - The value to replace the variable with. - `options`: `EnvironmentVariableMutatorOptions | undefined` - Options applied to the mutator, when no options are provided this will default to `{ applyAtProcessCreation: true }`. **Returns:** `void`
(scoped global-environment-variable-collection scope)
Gets scope-specific environment variable collection for the extension. This enables alterations to terminal environment variables solely within the designated scope, and is applied in addition to (and after) the global collection.
Each object obtained through this method is isolated and does not impact objects for other scopes, including the global collection.
Parameters:
scope
: EnvironmentVariableScope
- The scope to which the environment variable collection applies to.If a scope parameter is omitted, collection applicable to all relevant scopes for that parameter is returned. For instance, if the 'workspaceFolder' parameter is not specified, the collection that applies across all workspace folders will be returned.
Returns: EnvironmentVariableCollection
- Environment variable collection for the passed in scope.
Gets scope-specific environment variable collection for the extension. This enables alterations to terminal environment variables solely within the designated scope, and is applied in addition to (and after) the global collection. Each object obtained through this method is isolated and does not impact objects for other scopes, including the global collection. **Parameters:** - `scope`: `EnvironmentVariableScope` - The scope to which the environment variable collection applies to. If a scope parameter is omitted, collection applicable to all relevant scopes for that parameter is returned. For instance, if the 'workspaceFolder' parameter is not specified, the collection that applies across all workspace folders will be returned. **Returns:** `EnvironmentVariableCollection` - Environment variable collection for the passed in scope.
(set-description! global-environment-variable-collection value)
A description for the environment variable collection, this will be used to describe the changes in the UI.
A description for the environment variable collection, this will be used to describe the changes in the UI.
(set-persistent! global-environment-variable-collection value)
Whether the collection should be cached for the workspace and applied to the terminal across window reloads. When true the collection will be active immediately such when the window reloads. Additionally, this API will return the cached version if it exists. The collection will be invalidated when the extension is uninstalled or when the collection is cleared. Defaults to true.
Whether the collection should be cached for the workspace and applied to the terminal across window reloads. When true the collection will be active immediately such when the window reloads. Additionally, this API will return the cached version if it exists. The collection will be invalidated when the extension is uninstalled or when the collection is cleared. Defaults to true.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close