This should launch a new browser window with debugging enabled..
-Underlying exception:
-{ex}
- ");
-
- return;
- }
-
- var matchingTabs = availableTabs
- .Where(t => t.Url.Equals(targetTabUrl, StringComparison.Ordinal))
- .ToList();
- if (matchingTabs.Count == 0)
- {
- await context.Response.WriteAsync($@"
- Unable to find debuggable browser tab
-
- The response from {debuggerTabsListUrl} does not include
- any entry for {targetTabUrl}.
-
");
- return;
- }
- else if (matchingTabs.Count > 1)
- {
- // TODO: Automatically disambiguate by adding a GUID to the page title
- // when you press the debugger hotkey, include it in the querystring passed
- // here, then remove it once the debugger connects.
- await context.Response.WriteAsync($@"
- Multiple matching tabs are open
-
- There is more than one browser tab at {targetTabUrl}.
- Close the ones you do not wish to debug, then refresh this page.
-
");
- return;
- }
-
- // Now we know uniquely which tab to debug, construct the URL to the debug
- // page and redirect there
- var tabToDebug = matchingTabs.Single();
- var underlyingV8Endpoint = tabToDebug.WebSocketDebuggerUrl;
- var proxyEndpoint = GetProxyEndpoint(request, underlyingV8Endpoint);
- var devToolsUrlAbsolute = new Uri(debuggerHost + tabToDebug.DevtoolsFrontendUrl);
- var devToolsUrlWithProxy = $"{devToolsUrlAbsolute.Scheme}://{devToolsUrlAbsolute.Authority}{devToolsUrlAbsolute.AbsolutePath}?{proxyEndpoint.Scheme}={proxyEndpoint.Authority}{proxyEndpoint.PathAndQuery}";
- context.Response.Redirect(devToolsUrlWithProxy);
- }
-
- private static Uri GetProxyEndpoint(HttpRequest incomingRequest, string browserEndpoint)
- {
- var builder = new UriBuilder(
- schemeName: incomingRequest.IsHttps ? "wss" : "ws",
- hostName: incomingRequest.Host.Host)
- {
- Path = $"{incomingRequest.PathBase}/_framework/debug/ws-proxy",
- Query = $"browser={WebUtility.UrlEncode(browserEndpoint)}"
- };
-
- if (incomingRequest.Host.Port.HasValue)
- {
- builder.Port = incomingRequest.Host.Port.Value;
- }
-
- return builder.Uri;
- }
-
- private static string GetLaunchChromeInstructions(string appRootUrl)
- {
- var profilePath = Path.Combine(Path.GetTempPath(), "blazor-chrome-debug");
- var debuggerPort = GetDebuggerPort();
-
- if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
- {
- return $@"Press Win+R and enter the following:
- chrome --remote-debugging-port={debuggerPort} --user-data-dir=""{profilePath}"" {appRootUrl}
";
- }
- else if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
- {
- return $@"In a terminal window execute the following:
- google-chrome --remote-debugging-port={debuggerPort} --user-data-dir={profilePath} {appRootUrl}
";
- }
- else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
- {
- return $@"Execute the following:
- open /Applications/Google\ Chrome.app --args --remote-debugging-port={debuggerPort} --user-data-dir={profilePath} {appRootUrl}
";
- }
- else
- {
- throw new InvalidOperationException("Unknown OS platform");
- }
- }
-
- private static string GetLaunchEdgeInstructions(string appRootUrl)
- {
- var profilePath = Path.Combine(Path.GetTempPath(), "blazor-edge-debug");
- var debugggerPort = GetDebuggerPort();
-
- if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
- {
- return $@"Press Win+R and enter the following:
- msedge --remote-debugging-port={debugggerPort} --user-data-dir=""{profilePath}"" --no-first-run {appRootUrl}
";
- }
- else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
- {
- return $@"In a terminal window execute the following:
- open /Applications/Microsoft\ Edge\ Dev.app --args --remote-debugging-port={debugggerPort} --user-data-dir={profilePath} {appRootUrl}
";
- }
- else
- {
- return $@"Edge is not current supported on your platform
";
- }
- }
-
- private static async Task GetBrowserVersionInfoAsync()
- {
- using var httpClient = new HttpClient { Timeout = TimeSpan.FromSeconds(5) };
- var debuggerHost = GetDebuggerHost();
- var response = await httpClient.GetAsync($"{debuggerHost}/json/version");
- return await response.Content.ReadAsStreamAsync();
- }
-
- private static async Task> GetOpenedBrowserTabs()
- {
- using var httpClient = new HttpClient { Timeout = TimeSpan.FromSeconds(5) };
- var debuggerHost = GetDebuggerHost();
- var jsonResponse = await httpClient.GetStringAsync($"{debuggerHost}/json");
- return JsonSerializer.Deserialize(jsonResponse, JsonOptions);
- }
-
- class BrowserTab
- {
- public string Id { get; set; }
- public string Type { get; set; }
- public string Url { get; set; }
- public string Title { get; set; }
- public string DevtoolsFrontendUrl { get; set; }
- public string WebSocketDebuggerUrl { get; set; }
- }
- }
-}
diff --git a/src/Components/WebAssembly/Server/src/WebAssemblyNetDebugProxyAppBuilderExtensions.cs b/src/Components/WebAssembly/Server/src/WebAssemblyNetDebugProxyAppBuilderExtensions.cs
new file mode 100644
index 000000000000..2ad827c336be
--- /dev/null
+++ b/src/Components/WebAssembly/Server/src/WebAssemblyNetDebugProxyAppBuilderExtensions.cs
@@ -0,0 +1,46 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System.Net;
+
+namespace Microsoft.AspNetCore.Builder
+{
+ ///
+ /// Provides infrastructure for debugging Blazor WebAssembly applications.
+ ///
+ public static class WebAssemblyNetDebugProxyAppBuilderExtensions
+ {
+ ///
+ /// Adds middleware for needed for debugging Blazor WebAssembly applications
+ /// inside Chromium dev tools.
+ ///
+ public static void UseWebAssemblyDebugging(this IApplicationBuilder app)
+ {
+ app.Map("/_framework/debug", app =>
+ {
+ app.Use(async (context, next) =>
+ {
+ var debugProxyBaseUrl = await DebugProxyLauncher.EnsureLaunchedAndGetUrl(context.RequestServices);
+ var requestPath = context.Request.Path.ToString();
+ if (requestPath == string.Empty)
+ {
+ requestPath = "/";
+ }
+
+ // Although we could redirect for every URL we see here, we filter the allowed set
+ // to ensure this doesn't get misused as some kind of more general redirector
+ switch (requestPath)
+ {
+ case "/":
+ case "/ws-proxy":
+ context.Response.Redirect($"{debugProxyBaseUrl}{requestPath}{context.Request.QueryString}");
+ break;
+ default:
+ context.Response.StatusCode = (int)HttpStatusCode.NotFound;
+ break;
+ }
+ });
+ });
+ }
+ }
+}
diff --git a/src/Components/WebAssembly/Server/src/build/Microsoft.AspNetCore.Components.WebAssembly.Server.targets b/src/Components/WebAssembly/Server/src/build/Microsoft.AspNetCore.Components.WebAssembly.Server.targets
new file mode 100644
index 000000000000..ffa102691e2b
--- /dev/null
+++ b/src/Components/WebAssembly/Server/src/build/Microsoft.AspNetCore.Components.WebAssembly.Server.targets
@@ -0,0 +1,16 @@
+
+
+
+
+
+ <_DebugProxyBinaries Include="$(MSBuildThisFileDirectory)..\tools\BlazorDebugProxy\**" />
+
+
+
+
+
+
diff --git a/src/Components/WebAssembly/testassets/HostedInAspNet.Server/Properties/launchSettings.json b/src/Components/WebAssembly/testassets/HostedInAspNet.Server/Properties/launchSettings.json
new file mode 100644
index 000000000000..959797907279
--- /dev/null
+++ b/src/Components/WebAssembly/testassets/HostedInAspNet.Server/Properties/launchSettings.json
@@ -0,0 +1,29 @@
+{
+ "iisSettings": {
+ "windowsAuthentication": false,
+ "anonymousAuthentication": true,
+ "iisExpress": {
+ "applicationUrl": "http://localhost:56500/",
+ "sslPort": 44347
+ }
+ },
+ "profiles": {
+ "IIS Express": {
+ "commandName": "IISExpress",
+ "launchBrowser": true,
+ "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
+ "environmentVariables": {
+ "ASPNETCORE_ENVIRONMENT": "Development"
+ }
+ },
+ "HostedInAspNet.Server": {
+ "commandName": "Project",
+ "launchBrowser": true,
+ "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
+ "environmentVariables": {
+ "ASPNETCORE_ENVIRONMENT": "Development"
+ },
+ "applicationUrl": "https://localhost:5001;http://localhost:5000"
+ }
+ }
+}
diff --git a/src/Components/WebAssembly/testassets/StandaloneApp/Properties/launchSettings.json b/src/Components/WebAssembly/testassets/StandaloneApp/Properties/launchSettings.json
new file mode 100644
index 000000000000..541c4c44680a
--- /dev/null
+++ b/src/Components/WebAssembly/testassets/StandaloneApp/Properties/launchSettings.json
@@ -0,0 +1,29 @@
+{
+ "iisSettings": {
+ "windowsAuthentication": false,
+ "anonymousAuthentication": true,
+ "iisExpress": {
+ "applicationUrl": "http://localhost:56502/",
+ "sslPort": 44332
+ }
+ },
+ "profiles": {
+ "IIS Express": {
+ "commandName": "IISExpress",
+ "launchBrowser": true,
+ "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
+ "environmentVariables": {
+ "ASPNETCORE_ENVIRONMENT": "Development"
+ }
+ },
+ "StandaloneApp": {
+ "commandName": "Project",
+ "launchBrowser": true,
+ "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
+ "environmentVariables": {
+ "ASPNETCORE_ENVIRONMENT": "Development"
+ },
+ "applicationUrl": "https://localhost:5001;http://localhost:5000"
+ }
+ }
+}
diff --git a/src/Shared/CommandLineUtils/Utilities/DotNetMuxer.cs b/src/Shared/CommandLineUtils/Utilities/DotNetMuxer.cs
new file mode 100644
index 000000000000..52c98b5eb251
--- /dev/null
+++ b/src/Shared/CommandLineUtils/Utilities/DotNetMuxer.cs
@@ -0,0 +1,58 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+// System.AppContext.GetData is not available in these frameworks
+#if !NET451 && !NET452 && !NET46 && !NET461
+
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Runtime.InteropServices;
+
+namespace Microsoft.Extensions.CommandLineUtils
+{
+ ///
+ /// Utilities for finding the "dotnet.exe" file from the currently running .NET Core application
+ ///
+ internal static class DotNetMuxer
+ {
+ private const string MuxerName = "dotnet";
+
+ static DotNetMuxer()
+ {
+ MuxerPath = TryFindMuxerPath();
+ }
+
+ ///
+ /// The full filepath to the .NET Core muxer.
+ ///
+ public static string MuxerPath { get; }
+
+ ///
+ /// Finds the full filepath to the .NET Core muxer,
+ /// or returns a string containing the default name of the .NET Core muxer ('dotnet').
+ ///
+ /// The path or a string named 'dotnet'.
+ public static string MuxerPathOrDefault()
+ => MuxerPath ?? MuxerName;
+
+ private static string TryFindMuxerPath()
+ {
+ var fileName = MuxerName;
+ if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+ {
+ fileName += ".exe";
+ }
+
+ var mainModule = Process.GetCurrentProcess().MainModule;
+ if (!string.IsNullOrEmpty(mainModule?.FileName)
+ && Path.GetFileName(mainModule.FileName).Equals(fileName, StringComparison.OrdinalIgnoreCase))
+ {
+ return mainModule.FileName;
+ }
+
+ return null;
+ }
+ }
+}
+#endif