CefSharp 使用 DevToolsClient 执行 Chrome DevTools Protocol(CDP) 方法，以及调试CDP

Chrome DevTools Protocol (CDP)是 Chrome 开始开放的一个WebSocket通信协议。

可以访问 https://chromedevtools.github.io/devtools-protocol/ 官方文档查看websocket通信时的各种接口调用参数。

接口通信使用json格式:

请求:

{
        "id": "消息ID",
        "method": "方法名称",
        "params": {}
}

id: messageId,数字类型,不能为0，最好不要重复,要通过messageId区分响应信息

method: CDP 方法名称(Browser.getVersion、Page.getResourceTree...)

params: 请求方法参数

响应:

{
    “id”: "请求时传入的消息Id" ,
    "result": {}
}

开发者工具的所有操作都是遵循的这个协议，也就是说可以通过这个协议，绕开chrome 各种限制(ಥ_ಥ),比如获取网页所有标签详细信息(包括嵌套的iframe)。

执行Chrome DevTools Protocol 方法:

DevToolsClient 是CefSharp 专门对 CDP 接口做的的封装(Page、DOM、Browser...等等)，或者通过ExecuteDevToolsMethodAsync手动执行方法：

声明DevToolsClient全局变量:

//声明全局变量
DevToolsClient devTool = null;
//添加ChromiumWebBrowser初始化事件,初始化时赋值
private void Form1_Load(object sender, EventArgs e)
{
    DevToolsClient chromiumWebBrowser1.IsBrowserInitializedChanged += new EventHandler(delegate {
        devTool = chromiumWebBrowser1.GetBrowser().GetDevToolsClient();
    });
}

执行自定义方法:

//添加一个执行方法
public async Task<string> ExecuteDevToolsMethods(string method, IDictionary<string, object> param = null)
{
       DevToolsMethodResponse resp = await devTool.ExecuteDevToolsMethodAsync(method, param);
       return resp.ResponseAsJsonString;
}
//执行
private void button1_Click(object sender, EventArgs e)
{
    ExecuteDevToolsMethods("DOM.getDocument").ContinueWith(new Action<Task<string>>((result) =>
    {
        Console.WriteLine(result.Result);
    }));
}

注意: 不要使用Wait()等待函数,不然会导致卡死

或者使用CefSharp封装好的对象调用:

private async void button1_Click(object sender, EventArgs e)
{
    await devTool.Browser.GetVersionAsync().ContinueWith(new Action<Task<GetVersionResponse>>((resp)=> {
        Console.WriteLine(resp);
    }));
}

如果使用CefSharp封装对象调用时，需要在执行方法体上添加async/await,才不会导致程序卡死。

可以看一下 stackoverflow 中锁死的几种情况：https://stackoverflow.com/questions/65895251/cefsharp-use-devtoolsclient-execute-method-after-call-wait-function-waiting/65895577?noredirect=1#comment116512155_65895577

不熟悉async/await的原理，如果各位有好的处理建议，请留言，非常感谢！

调试CDP接口:

配置CefSettings, 指定CefSharp 启动时打开远程调试端口:

CefSettings _settings = new CefSettings();
_settings.RemoteDebuggingPort = 32999;
Cef.Initialize(_settings);

一定要在创建窗体时执行配置全局CefSettings配置:

        public Form1()
        {
            InitializeComponent();
            CefSettings _settings = new CefSettings();
            _settings.RemoteDebuggingPort = 32999;//调试端口,一会程序启动后，需要访问这个端口
            Cef.Initialize(_settings);
        }

如果在其他地方配置时会报(暂时还没找到原因...):

CEF can only be initialized once per process. This is a limitation of the underlying CEF/Chromium framework. You can change many (not all) settings at runtime through RequestContext.SetPreference.

这时启动程序，不出意外的话，直接访问: {ip}:{port}(localhost:32999)：