Core - Support Chrome command execution.

CefSharp.Core.Runtime.RefAssembly/CefSharp.Core.Runtime.netcore.cs

@@ -1,4 +1,4 @@
-//------------------------------------------------------------------------------
+//------------------------------------------------------------------------------
 // <auto-generated>
 //     This code was generated by a tool.
 //     GenAPI Version: 5.0.2.37403
@@ -85,6 +85,7 @@ public static void EnableWaitForBrowsersToClose() { }
         public static bool Initialize(CefSharp.Core.CefSettingsBase cefSettings, bool performDependencyCheck, CefSharp.IApp cefApp) { throw null; }
         public static bool Initialize(CefSharp.Core.CefSettingsBase cefSettings, bool performDependencyCheck, CefSharp.IBrowserProcessHandler browserProcessHandler) { throw null; }
         public static bool IsWindows10OrGreaterEx() { throw null; }
+        public static int GetCefIdForCommandIdName(string name) { throw null; }
         public static CefSharp.UrlParts ParseUrl(string url) { throw null; }
         public static bool PostAction(CefSharp.CefThreadIds threadId, System.Action action) { throw null; }
         public static bool PostDelayedAction(CefSharp.CefThreadIds threadId, System.Action action, int delayInMs) { throw null; }

CefSharp.Core.Runtime/Cef.h

@@ -12,12 +12,14 @@
 #include "versionhelpers.h";
 #include <msclr/lock.h>
 #include <msclr/marshal.h>
+#include <msclr/marshal_cppstd.h>
 #include <include/cef_version.h>
 #include <include/cef_origin_whitelist.h>
 #include <include/cef_crash_util.h>
 #include <include/cef_parser.h>
 #include <include/cef_task.h>
 #include <include/internal/cef_types.h>
+#include <include/cef_id_mappers.h>
 
 #include "Internals/CefSharpApp.h"
 #include "Internals/CefTaskScheduler.h"
@@ -973,6 +975,18 @@ namespace CefSharp
             {
                 return IsWindows10OrGreater();
             }
+
+            static int GetCefIdForCommandIdName(String^ name)
+            {
+                if (String::IsNullOrEmpty(name))
+                {
+                    return -1;
+                }
+
+                std::string nativeString = marshal_as<std::string>(name);
+
+                return cef_id_for_command_id_name(nativeString.c_str());
+            }
         };
     }
 }

CefSharp.Core.Runtime/CefIdMappers.cpp

@@ -0,0 +1,29 @@
+// Copyright © 2026 The CefSharp Authors. All rights reserved.
+//
+// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
+
+#include "Stdafx.h"
+
+#include "CefIdMappers.h"
+#include "include\cef_id_mappers.h"
+#include <msclr/marshal_cppstd.h>
+
+using namespace msclr::interop;
+
+namespace CefSharp
+{
+    namespace Core
+    {
+        int CefIdMappers::CefIdForCommandIdName(String^ name)
+        {
+            if (String::IsNullOrEmpty(name))
+            {
+                return -1;
+            }
+
+            std::string nativeString = marshal_as<std::string>(name);
+
+            return cef_id_for_command_id_name(nativeString.c_str());
+        }
+    };
+}

CefSharp.Core.Runtime/CefIdMappers.h

@@ -0,0 +1,21 @@
+// Copyright © 2026 The CefSharp Authors. All rights reserved.
+//
+// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
+
+#pragma once
+
+#include "Stdafx.h"
+
+namespace CefSharp
+{
+    namespace Core
+    {
+        /// <exclude />
+        [System::ComponentModel::EditorBrowsableAttribute(System::ComponentModel::EditorBrowsableState::Never)]
+        public ref class CefIdMappers sealed
+        {
+        public:
+            static int CefIdForCommandIdName(String^ name);
+        };
+    }
+}

CefSharp.Core.Runtime/Internals/CefBrowserHostWrapper.cpp

@@ -639,6 +639,25 @@ void CefBrowserHostWrapper::SetAudioMuted(bool mute)
     _browserHost->SetAudioMuted(mute);
 }
 
+bool CefBrowserHostWrapper::CanExecuteChromeCommand(int commandId)
+{
+    ThrowIfDisposed();
+
+    if (CefCurrentlyOn(TID_UI))
+    {
+        return _browserHost->CanExecuteChromeCommand(commandId);
+    }
+
+    throw gcnew InvalidOperationException("This method can only be called directly on the CEF UI Thread. Use CanExecuteChromeCommandAsync or use Cef.UIThreadTaskFactory to marshal the call onto the CEF UI Thread.");
+}
+
+void CefBrowserHostWrapper::ExecuteChromeCommand(int commandId, WindowOpenDisposition disposition)
+{
+    ThrowIfDisposed();
+
+    _browserHost->ExecuteChromeCommand(commandId, (cef_window_open_disposition_t)disposition);
+}
+
 IntPtr CefBrowserHostWrapper::GetOpenerWindowHandle()
 {
     ThrowIfDisposed();

CefSharp.Core.Runtime/Internals/CefBrowserHostWrapper.h

@@ -140,6 +140,10 @@ namespace CefSharp
 
             virtual void SetAudioMuted(bool mute);
 
+            virtual bool CanExecuteChromeCommand(int commandId);
+
+            virtual void ExecuteChromeCommand(int commandId, WindowOpenDisposition disposition);
+
             virtual IntPtr GetOpenerWindowHandle();
 
             virtual void SendExternalBeginFrame();

CefSharp.Core/Cef.cs

@@ -769,5 +769,21 @@ public static void AssertIsWindows10OrGreater()
             if (!IsWindows10OrGreater())
                 throw new ApplicationException("Current OS version is less than Windows 10. Applications not manifested for Windows 10 throw this exception, even if the current operating system version is Windows 10. To manifest your applications for Windows 10, see https://learn.microsoft.com/en-us/windows/win32/sysinfo/targeting-your-application-at-windows-8-1.");
         }
+
+        /// <summary>
+        /// Returns the numeric ID value for an IDC <paramref name="name"/> from cef_command_ids.h or -1
+        /// if <paramref name="name"/> is unrecognized by the current CEF/Chromium build.
+        /// </summary>
+        /// <remarks>
+        /// This function provides version-safe mapping of command IDC names to version-specific
+        /// numeric ID values. Numeric ID values are likely to change across
+        /// CEF/Chromium versions but names generally remain the same.
+        /// </remarks>
+        /// <param name="name">String identifier of the Chromium command.</param>
+        /// <returns>version-specific numeric ID value for the command if recognized; otherwise, -1.</returns>
+        public static int GetCefIdForCommandIdName(string name)
+        {
+            return Core.Cef.GetCefIdForCommandIdName(name);
+        }
     }
 }

CefSharp.Core/WebBrowserExtensionsEx.cs

@@ -265,5 +265,54 @@ public static Task<T> EvaluateScriptAsync<T>(this IChromiumWebBrowserBase chromi
 
             return chromiumWebBrowser.BrowserCore.EvaluateScriptAsync<T>(script, timeout);
         }
+
+        /// <summary>
+        /// Asynchronously returns true if a Chrome command is supported and enabled. Only used with Chrome style.
+        /// </summary>
+        /// <param name="browser">The <see cref="IBrowser"/> instance this method extends.</param>
+        /// <param name="commandId">The command id.</param>
+        /// <returns>
+        /// <see cref="Task{T}"/> that can be awaited to obtain the availability of the Chrome command.
+        /// </returns>
+        public static Task<bool> CanExecuteChromeCommandAsync(this IBrowser browser, int commandId)
+        {
+            WebBrowserExtensions.ThrowExceptionIfBrowserNull(browser);
+
+            var host = browser.GetHost();
+            WebBrowserExtensions.ThrowExceptionIfBrowserHostNull(host);
+
+            if (Cef.CurrentlyOnThread(CefThreadIds.TID_UI))
+            {
+                var availability = host.CanExecuteChromeCommand(commandId);
+
+                return Task.FromResult<bool>(availability);
+            }
+
+            var tcs = new TaskCompletionSource<bool>(TaskCreationOptions.RunContinuationsAsynchronously);
+
+            Cef.UIThreadTaskFactory.StartNew(delegate
+            {
+                var availability = host.CanExecuteChromeCommand(commandId);
+
+                tcs.TrySetResult(availability);
+            });
+
+            return tcs.Task;
+        }
+
+        /// <summary>
+        /// Asynchronously returns true if a Chrome command is supported and enabled. Only used with Chrome style.
+        /// </summary>
+        /// <param name="browser">The ChromiumWebBrowser instance this method extends.</param>
+        /// <param name="commandId">The command id.</param>
+        /// <returns>
+        /// <see cref="Task{T}"/> that can be awaited to obtain the availability of the Chrome command.
+        /// </returns>
+        public static Task<bool> CanExecuteChromeCommandAsync(this IChromiumWebBrowserBase browser, int commandId)
+        {
+            WebBrowserExtensions.ThrowExceptionIfChromiumWebBrowserDisposed(browser);
+
+            return browser.BrowserCore.CanExecuteChromeCommandAsync(commandId);
+        }
     }
 }