Add a Program.Main() override with a throwOnError parameter

Ensuring that playwright is properly installed can be done by running the following code:

```csharp
var playwright = new Microsoft.Playwright.Program();
var exitCode = playwright.Run(["install", "--with-deps"]);
```

This is fine when the installation succeeds and the exit code is 0. But when running under xUnit.net (which [does **not** capture the console output](https://xunit.net/docs/capturing-output)) and the installation fails with exit code 1, then it becomes impossibly hard to diagnose the root cause of the failure.

For example, a failure can be triggered by deleting the installed browers in the `ms-playwright` cache directory and setting the `https_proxy` environment variable to an invalid proxy: `http://127.0.0.1:33333`.

Under these conditions, running with the new `throwOnError` parameter becomes diagnosable.

```csharp
var playwright = new Microsoft.Playwright.Program();
var exitCode = playwright.Run(["install", "--with-deps", "firefox"], throwOnError: true);
```

This throws a `PlaywrightException` with the exact command executed and its output, making it clear what the problem is.

> Failed to run ~/playwright-dotnet/src/playwright-xunit/bin/Debug/net8.0/.playwright/node/darwin-x64/node "~/playwright-dotnet/src/playwright-xunit/bin/Debug/net8.0/.playwright/package/cli.js" "install" "--with-deps" "firefox"
> Downloading Firefox 132.0 (playwright build v1466) from https://playwright.azureedge.net/builds/firefox/1466/firefox-mac.zip
> Error: connect ECONNREFUSED 127.0.0.1:33333
>     at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1610:16) {
>   errno: -61,
>   code: 'ECONNREFUSED',
>   syscall: 'connect',
>   address: '127.0.0.1',
>   port: 33333
> }
> Downloading Firefox 132.0 (playwright build v1466) from https://playwright-akamai.azureedge.net/builds/firefox/1466/firefox-mac.zip
> Error: connect ECONNREFUSED 127.0.0.1:33333
>     at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1610:16) {
>   errno: -61,
>   code: 'ECONNREFUSED',
>   syscall: 'connect',
>   address: '127.0.0.1',
>   port: 33333
> }
> Downloading Firefox 132.0 (playwright build v1466) from https://playwright-verizon.azureedge.net/builds/firefox/1466/firefox-mac.zip
> Error: connect ECONNREFUSED 127.0.0.1:33333
>     at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1610:16) {
>   errno: -61,
>   code: 'ECONNREFUSED',
>   syscall: 'connect',
>   address: '127.0.0.1',
>   port: 33333
> }
> Failed to install browsers
> Error: Failed to download Firefox 132.0 (playwright build v1466), caused by
> Error: Download failure, code=1

Author: 0xced

src/Playwright/Program.cs

@@ -24,6 +24,7 @@
 
 using System;
 using System.Diagnostics;
+using System.IO;
 using Microsoft.Playwright.Helpers;
 
 namespace Microsoft.Playwright;
@@ -37,14 +38,19 @@ public static int Main(string[] args)
     }
 
     public int Run(string[] args)
+    {
+        return Run(args, throwOnError: false);
+    }
+
+    public int Run(string[] args, bool throwOnError)
     {
         Func<string?, string> getArgs;
         string executablePath;
         try
         {
             (executablePath, getArgs) = Driver.GetExecutablePath();
         }
-        catch
+        catch when (!throwOnError)
         {
             return PrintError("Microsoft.Playwright assembly was found, but is missing required assets. Please ensure to build your project before running Playwright tool.");
         }
@@ -55,6 +61,8 @@ public int Run(string[] args)
             // This works after net8.0-preview-4
             // https://github.com/dotnet/runtime/pull/82662
             WindowStyle = ProcessWindowStyle.Hidden,
+            RedirectStandardOutput = throwOnError,
+            RedirectStandardError = throwOnError,
         };
         foreach (var pair in Driver.EnvironmentVariables)
         {
@@ -66,9 +74,26 @@ public int Run(string[] args)
             StartInfo = playwrightStartInfo,
         };
 
+        using var pwOutput = new StringWriter();
+        if (throwOnError)
+        {
+            pwProcess.OutputDataReceived += (_, eventArgs) => pwOutput.WriteLine(eventArgs.Data);
+            pwProcess.ErrorDataReceived += (_, eventArgs) => pwOutput.WriteLine(eventArgs.Data);
+        }
         pwProcess.Start();
+        if (throwOnError)
+        {
+            pwProcess.BeginOutputReadLine();
+            pwProcess.BeginErrorReadLine();
+        }
 
         pwProcess.WaitForExit();
+
+        if (pwProcess.ExitCode != 0 && throwOnError)
+        {
+            throw new PlaywrightException($"Failed to run {playwrightStartInfo.FileName} {playwrightStartInfo.Arguments}{Environment.NewLine}{pwOutput.ToString().Trim()}");
+        }
+
         return pwProcess.ExitCode;
     }