WPF应用中使用CefSharp绑定.NET对象到JS时出现cefsharp未定义错误

核心原因 #

cefsharp全局对象未定义，说明CefSharp的JavaScript绑定脚本未正常加载，或是初始化配置、对象注册步骤存在错误。以下是分步解决方案：

1. 初始化Cef时启用JS绑定支持 #

在应用启动阶段初始化Cef时，必须开启绑定相关特性配置：

var settings = new CefSettings();
// 若加载本地HTML文件，需允许跨文件访问（可选但常用）
settings.JavascriptFlags = "--allow-file-access-from-files";
// 强制启用JS绑定所需的Blink特性
settings.CefCommandLineArgs.Add("enable-blink-features", "JavascriptBindings");

// 全局仅需初始化一次Cef
if (!Cef.IsInitialized)
{
    Cef.Initialize(settings);
}

2. 正确注册.NET对象到JavaScriptObjectRepository #

必须在浏览器初始化完成后注册对象，避免过早注册导致无效：

private void ChromiumWebBrowser_IsBrowserInitializedChanged(object sender, DependencyPropertyChangedEventArgs e)
{
    var browser = sender as ChromiumWebBrowser;
    if (browser != null && browser.IsBrowserInitialized)
    {
        // isAsync设为true，对应JS端的BindObjectAsync方法
        browser.JavascriptObjectRepository.Register(
            "jsobject", 
            new BoundObject(), 
            isAsync: true,
            options: BindingOptions.DefaultBinder
        );
    }
}

注意：BoundObject的方法必须是public，异步方法返回Task/Task<T>，同步方法会自动被包装为Promise供JS调用。

3. 调整JS代码执行时机 #

确保JS代码在页面DOM加载完成后执行，等待CefSharp内置脚本加载完毕：

document.addEventListener('DOMContentLoaded', async () => {
    try {
        // 绑定.NET对象
        const jsObj = await cefsharp.BindObjectAsync('jsobject');
        // 调用.NET方法
        const appId = await jsObj.AppId();
        const appCode = await jsObj.AppCode();
        console.log("AppId:", appId, "AppCode:", appCode);
    } catch (error) {
        console.error("绑定或调用失败:", error);
    }
});

4. 修复ResolveObject事件的使用方式 #

若使用ResolveObject事件动态提供对象，需确保事件在浏览器加载页面前绑定：

public MainWindow()
{
    InitializeComponent();
    // 提前绑定ResolveObject事件
    chromiumWebBrowser.JavascriptObjectRepository.ResolveObject += OnResolveObject;
}

private void OnResolveObject(object sender, JavascriptBindingEventArgs e)
{
    if (e.ObjectName == "jsobject")
    {
        e.Object = new BoundObject();
        e.Success = true; // 必须设为true表示成功解析对象
    }
}

内容的提问来源于stack exchange，提问作者Rachana Shettigar