feat(vscode): add configuration for output file display options

Add "robotcode.run.openOutputTarget" setting to control how Robot Framework output files are displayed:
- simpleBrowser: in VSCode's built-in browser
- externalHttp: in default browser via HTTP protocol
- externalFile: in default browser via file system

The externalFile options may not run in remote development environments.

Closes #391
Closes #227

Author: d-biehl

package.json

@@ -757,6 +757,22 @@
             "default": "none",
             "description": "Defines if the report or log file should be opened after a run.",
             "scope": "resource"
+          },
+          "robotcode.run.openOutputTarget": {
+            "type": "string",
+            "enum": [
+              "simpleBrowser",
+              "externalHttp",
+              "externalFile"
+            ],
+            "enumDescriptions": [
+              "Display the output file in a simple VSCode browser window.",
+              "Display the output file in your default web browser via HTTP.",
+              "Display the output file in your default browser via the file system."
+            ],
+            "default": "simpleBrowser",
+            "description": "Specifies how Robot Framework output files should be displayed when opened.",
+            "scope": "resource"
           }
         }
       },
@@ -1943,4 +1959,4 @@
   "workspaces": [
     "docs"
   ]
-}
+}

vscode-client/extension/debugmanager.ts

@@ -612,10 +612,11 @@ export class DebugManager {
     logFile?: string,
     reportFile?: string,
   ): Promise<void> {
-    if (session.configuration?.openOutputAfterRun === "report" && reportFile) {
-      await this.languageClientsManager.openUriInDocumentationView(vscode.Uri.file(reportFile));
-    } else if (session.configuration?.openOutputAfterRun === "log" && logFile) {
-      await this.languageClientsManager.openUriInDocumentationView(vscode.Uri.file(logFile));
+    const openMode = session.configuration?.openOutputAfterRun as string;
+    const fileToOpen = openMode === "report" ? reportFile : openMode === "log" ? logFile : undefined;
+
+    if (fileToOpen) {
+      await this.languageClientsManager.openOutputFile(vscode.Uri.file(fileToOpen));
     }
   }
 }

vscode-client/extension/index.ts

@@ -116,7 +116,7 @@ export async function activateAsync(context: vscode.ExtensionContext): Promise<v
         return [];
       },
       async handleTerminalLink(link: TerminalLink) {
-        await languageClientManger.openUriInDocumentationView(vscode.Uri.file(link.path));
+        await languageClientManger.openOutputFile(vscode.Uri.file(link.path));
       },
     }),
 

vscode-client/extension/languageclientsmanger.ts

@@ -794,6 +794,25 @@ export class LanguageClientsManager {
     }
   }
 
+  public async openOutputFile(file: vscode.Uri): Promise<void> {
+    const workspace = vscode.workspace.getWorkspaceFolder(file);
+    const result = vscode.workspace.getConfiguration(CONFIG_SECTION, workspace).get<string>("run.openOutputTarget");
+
+    switch (result) {
+      case "simpleBrowser":
+        await this.openUriInDocumentationView(file);
+        break;
+      case "externalHttp":
+        await vscode.env.openExternal(
+          await vscode.env.asExternalUri((await this.convertToDocumentationUri(file)) ?? file),
+        );
+        break;
+      case "externalFile":
+        await vscode.env.openExternal(file);
+        break;
+    }
+  }
+
   public async convertToDocumentationUri(
     uri: vscode.Uri,
     token?: vscode.CancellationToken | undefined,