Add setting to determine console focus behavior on script execution

This change adds a new setting that controls whether focus changes to the
integrated console when scripts are executed or debugged:

- `powershell.integratedConsole.focusConsoleOnExecute`

When true, it causes the focus to get set to the console on any script
execution.  It is set to true by default to ensure that screen readers
pick up the execution output once it starts.

Resolves #588.

Author: daviwil

package.json

@@ -403,6 +403,11 @@
           "type": "boolean",
           "default": true,
           "description": "If true, causes the integrated console to be shown automatically when the PowerShell extension is initialized."
+        },
+        "powershell.integratedConsole.focusConsoleOnExecute": {
+          "type": "boolean",
+          "default": true,
+          "description": "If true, causes the integrated console to be focused when a script selection is run or a script file is debugged."
         }
       }
     }

src/features/Console.ts

@@ -217,7 +217,7 @@ export class ConsoleFeature implements IFeature {
                 });
 
                 // Show the integrated console if it isn't already visible
-                vscode.commands.executeCommand("PowerShell.ShowSessionConsole");
+                vscode.commands.executeCommand("PowerShell.ShowSessionConsole", true);
             })
         ];
     }

src/features/DebugSession.ts

@@ -63,7 +63,7 @@ export class DebugSessionFeature implements IFeature {
 
         // Create or show the interactive console
         // TODO #367: Check if "newSession" mode is configured
-        vscode.commands.executeCommand('PowerShell.ShowSessionConsole');
+        vscode.commands.executeCommand('PowerShell.ShowSessionConsole', true);
 
         vscode.commands.executeCommand('vscode.startDebug', config);
     }

src/session.ts

@@ -64,6 +64,7 @@ export class SessionManager {
     private hostVersion: string;
     private isWindowsOS: boolean;
     private sessionStatus: SessionStatus;
+    private focusConsoleOnExecute: boolean;
     private statusBarItem: vscode.StatusBarItem;
     private sessionConfiguration: SessionConfiguration;
     private versionDetails: PowerShellVersionDetails;
@@ -105,6 +106,8 @@ export class SessionManager {
         this.sessionSettings = Settings.load(utils.PowerShellLanguageId);
         this.log.startNewLog(this.sessionSettings.developer.editorServicesLogLevel);
 
+        this.focusConsoleOnExecute = this.sessionSettings.integratedConsole.focusConsoleOnExecute;
+
         this.createStatusBarItem();
 
         this.sessionConfiguration = this.resolveSessionConfiguration(sessionConfig);
@@ -206,6 +209,8 @@ export class SessionManager {
     private onConfigurationUpdated() {
         var settings = Settings.load(utils.PowerShellLanguageId);
 
+        this.focusConsoleOnExecute = settings.integratedConsole.focusConsoleOnExecute;
+
         // Detect any setting changes that would affect the session
         if (settings.useX86Host !== this.sessionSettings.useX86Host ||
             settings.developer.powerShellExePath.toLowerCase() !== this.sessionSettings.developer.powerShellExePath.toLowerCase() ||
@@ -245,7 +250,7 @@ export class SessionManager {
             vscode.commands.registerCommand('PowerShell.RestartSession', () => { this.restartSession(); }),
             vscode.commands.registerCommand(this.ShowSessionMenuCommandName, () => { this.showSessionMenu(); }),
             vscode.workspace.onDidChangeConfiguration(() => this.onConfigurationUpdated()),
-            vscode.commands.registerCommand('PowerShell.ShowSessionConsole', () => { this.showSessionConsole(); })
+            vscode.commands.registerCommand('PowerShell.ShowSessionConsole', (isExecute?: boolean) => { this.showSessionConsole(isExecute); })
         ]
     }
 
@@ -629,9 +634,10 @@ export class SessionManager {
         return resolvedPath;
     }
 
-    private showSessionConsole() {
+    private showSessionConsole(isExecute?: boolean) {
         if (this.consoleTerminal) {
-            this.consoleTerminal.show(true);
+            this.consoleTerminal.show(
+                isExecute && !this.focusConsoleOnExecute);
         }
     }
 

src/settings.ts

@@ -43,6 +43,7 @@ export interface ISettings {
 
 export interface IIntegratedConsoleSettings {
     showOnStartup?: boolean;
+    focusConsoleOnExecute?: boolean;
 }
 
 export function load(myPluginId: string): ISettings {
@@ -75,6 +76,7 @@ export function load(myPluginId: string): ISettings {
 
     let defaultIntegratedConsoleSettings: IIntegratedConsoleSettings = {
         showOnStartup: true,
+        focusConsoleOnExecute: true
     };
 
     return {