隨著Web技術的發展和跨平台套用的需求增加，越來越多的開發者開始尋求在桌面應用程式中嵌入Web內容的方法。CefSharp是一個流行的開源計畫，它允許開發者在C# WinForms或WPF應用程式中嵌入Chromium瀏覽器引擎。CefSharp不僅提供了瀏覽器的基本功能，還允許C#程式碼與Web頁面中的JavaScript程式碼進行互動，為開發者帶來了極大的靈活性。本文將詳細介紹如何使用CefSharp實作C#與JavaScript的相互呼叫。
一、CefSharp簡介
CefSharp是一個基於Chromium Embedded Framework (CEF)的.NET封裝庫。它允許.NET開發者在WinForms或WPF應用程式中嵌入一個功能完整的瀏覽器引擎，從而能夠載入和渲染Web頁面。CefSharp不僅提供了瀏覽器控制項的基本功能，如導航、執行JavaScript程式碼等，還透過一系列的事件和API支持C#與JavaScript的相互呼叫。
二、C#呼叫JavaScript
在CefSharp中，C#程式碼可以透過
ExecuteScriptAsync
或
ExecuteScript
方法呼叫JavaScript程式碼。這兩個方法都接受一個包含JavaScript程式碼的字串作為參數，並返回一個表示執行結果的
Task<JavascriptResponse>
物件。
下面是一個簡單的範例，演示如何在C#中呼叫JavaScript函式：
// 假設你已經有了一個CefSharp瀏覽器控制項例項，名為browser
string script = "document.getElementById('myElement').innerHTML = 'Hello from C#';";
browser.ExecuteScriptAsync(script).ContinueWith(t =>
{
if (!t.IsFaulted)
{
var response = t.Result;
// 處理響應或忽略
}
else
{
// 處理錯誤
}
});
在上面的範例中，我們透過
ExecuteScriptAsync
方法執行了一個簡單的JavaScript程式碼，該程式碼修改了頁面上某個元素的文本內容。執行完成後，我們透過
ContinueWith
方法處理執行結果或錯誤。
三、JavaScript呼叫C#
要實作JavaScript呼叫C#，你需要在C#端定義一個可以被JavaScript呼叫的物件或方法，並將其註冊為瀏覽器的全域物件或方法。CefSharp提供了
RegisterJsObject
和
RegisterAsyncJsObject
方法來實作這一功能。
下面是一個範例，演示如何在C#中定義一個可以被JavaScript呼叫的方法，並將其註冊為瀏覽器的全域方法：
public classBoundObject
{
publicvoidCallMeFromJavascript(string message)
{
Console.WriteLine("Called from Javascript: " + message);
}
}
// 在初始化CefSharp瀏覽器控制項時註冊物件
browser.RegisterJsObject("boundAsync", new BoundObject(), BindingOptions.DefaultBinder);
在JavaScript中，你可以像呼叫普通JavaScript函式一樣呼叫
boundAsync.CallMeFromJavascript
方法：
// 在Web頁面的JavaScript程式碼中
boundAsync.CallMeFromJavascript('Hello from JavaScript!');
當JavaScript程式碼呼叫
boundAsync.CallMeFromJavascript
時，CefSharp會將其對映到C#端的
BoundObject.CallMeFromJavascript
方法，並傳遞相應的參數。這樣，你就實作了JavaScript到C#的呼叫。
四、註意事項和最佳實踐
安全性 ：當允許JavaScript呼叫C#程式碼時，要特別註意安全性問題。確保你只暴露必要的方法和物件，並驗證所有傳入的參數以防止潛在的攻擊。
效能 ：頻繁地在C#和JavaScript之間進行呼叫可能會對效能產生影響。在設計應用程式時，要盡量避免不必要的跨語言呼叫，並最佳化那些確實需要的呼叫。
錯誤處理 ：在C#端和JavaScript端都要實作適當的錯誤處理機制，以便在呼叫失敗時能夠捕獲並處理錯誤。
異步呼叫 ：對於可能耗時的操作，考慮使用異步呼叫來提高應用程式的響應性。CefSharp提供了異步執行JavaScript和註冊異步JavaScript物件的方法。
五、總結
CefSharp為C#開發者提供了一個強大的工具，用於在桌面應用程式中嵌入Chromium瀏覽器引擎並實作C#與JavaScript的相互呼叫。透過合理利用CefSharp的功能和API，開發者可以建立出功能豐富、互動性強的跨平台應用程式。在開發過程中，要註意安全性、效能和錯誤處理等方面的問題，以確保應用程式的穩定性和使用者體驗。
