Enhancement - Add DevToolsClient (Direct Devtools Protocol)

[amaitland]

Follow up to #3158

A nicer API build on top of the CEF API to make it easier to send/receive messages from DevTools.

The API is generated on top of the DevTools protocol to create a set of model classes to simplify executing DevTools commands.

• Add Strongly typed DevTools Domain classes
• Deprecated methods are not generated
• Only methods (no strongly typed events yet, a new issue should be created for that.)

The CefSharp.DevTools.DevToolsClient class is the primary method of accessing the different domains. Each DevTools Domain has it's own namespace that contains enums and strongly typed return classes.

Network Domain is part of the CefSharp.DevTools.Network namespace. The methods are accessibly though the DevToolsClient class.

Some basic examples look like (extract from the unit tests)

using (var browser = new ChromiumWebBrowser("www.google.com"))
{
	await browser.WaitForInitialLoadAsync();

	using (var devToolsClient = browser.GetDevToolsClient())
	{
		var response = await devToolsClient.Network.SetCookieAsync(name, value, domain: domain, sameSite: sameSite);
	}
}

using (var browser = new ChromiumWebBrowser("www.google.com"))
{
	await browser.WaitForInitialLoadAsync();

	using (var devToolsClient = browser.GetDevToolsClient())
	{
		var response = await devToolsClient.Browser.GetVersionAsync();
		var jsVersion = response.JsVersion;
		var revision = response.Revision;
	}
}

[amaitland]

CEF doesn't support every aspect of DevTools, the generated API is based of the protocol definition which can be downloaded from the browser at runtime and is used for code generation. If you find a method that CEF doesn't support please post here and I will at some point update the generator to remove those methods.

TO BE REMOVED:

• Page.printToPdf is only accessibly when using Headless Chromium and not supported.

[amaitland]

Developing features like this takes considerably time and effort, if you use CefSharp in a commercial application then please consider sponsoring me https://github.com/cefsharp/CefSharp#financial-support

[amaitland]

Example of changing User Agent at runtime at https://stackoverflow.com/a/64543667/4583726

[totti240282]

With GetDevToolsClient is possible capture traffic in network tab ?

[amaitland]

Yes. You can subscribe to http://cefsharp.github.io/api/85.3.x/html/F_CefSharp_DevTools_DevToolsClient_DevToolsEvent.htm

As per #3158 (comment) you must call enable/disable for the specific domain.

[amaitland]

For .Net core it might be worth generating some nicer code in relation to the JSON parsing involved here. Using https://docs.microsoft.com/en-us/dotnet/api/system.text.json?view=net-5.0 should be feasible.

[amaitland]

See https://gist.github.com/amaitland/eabb42a191c4943610f2407196b0e03a for an example of changing tge user agent at runtime using the DevTools protocol.