/// <summary>
/// Executes a method call over the DevTools protocol.
/// </summary>
/// <typeparam name="T">The type of object to return.</typeparam>
/// <param name="webview">The WebView control.</param>
/// <param name="method">The method name.</param>
/// <param name="parameters">
/// The JSON string with method parameters. May be null.
/// See the <see href="https://chromedevtools.github.io/devtools-protocol/">
/// DevTools Protocol documentation</see> for details of supported methods
/// and the expected parameters.
/// </param>
/// <param name="convert">
/// A callback function that converts the result content into an object of type <see cref="T"/>.
/// If null, a byte array containing a UTF-8-encoded copy of the content is returned.
/// </param>
/// <param name="cancellationToken">The token to monitor for cancellation requests.</param>
/// <returns>
/// The JSON string with the response. Structure of the response varies depending
/// on the method name and is defined by the 'RETURN OBJECT' section of
/// the Chrome DevTools Protocol command description.
/// </returns>
/// <remarks>
/// Usage of the ExecuteDevToolsMethodAsync function does not require an active
/// DevTools front-end or remote-debugging session. Other active DevTools sessions
/// will continue to function independently. However, any modification of global
/// browser state by one session may not be reflected in the UI of other sessions.
/// <para/>
/// Communication with the DevTools front-end (when displayed) can be logged
/// for development purposes by passing the `--devtools-protocol-log-
/// file=<path>` command-line flag.
/// </remarks>
public static Task<T> ExecuteDevToolsMethodAsync<T>(this IChromiumWebView webview, string method, string parameters, ConvertUtf8BufferToTypeDelegate<T> convert, CancellationToken cancellationToken)
where T : class
{
CefValue args = null;
if (parameters != null)
{
args = CefApi.CefParseJSON(parameters, CefJsonParserOptions.AllowTrailingCommas, out string errorMessage);
if (args is null)
throw new ArgumentOutOfRangeException(nameof(parameters), errorMessage is null ? "An error occurred during JSON parsing." : errorMessage);
}
return ExecuteDevToolsMethodAsync(webview, method, args is null ? default(CefDictionaryValue) : args.GetDictionary(), convert, cancellationToken);
}
/// <summary>
/// Executes a method call over the DevTools protocol.
/// </summary>
/// <typeparam name="T">The type of object to return.</typeparam>
/// <param name="webview">The WebView control.</param>
/// <param name="method">The method name.</param>
/// <param name="parameters">
/// The dictionaly with method parameters. May be null.
/// See the <see href="https://chromedevtools.github.io/devtools-protocol/">
/// DevTools Protocol documentation</see> for details of supported methods
/// and the expected parameters.
/// </param>
/// <param name="convert">
/// A callback function that converts the result content into an object of type <see cref="T"/>.
/// If null, a byte array containing a UTF-8-encoded copy of the content is returned.
/// </param>
/// <param name="cancellationToken">The token to monitor for cancellation requests.</param>
/// <returns>
/// The JSON string with the response. Structure of the response varies depending
/// on the method name and is defined by the 'RETURN OBJECT' section of
/// the Chrome DevTools Protocol command description.
/// </returns>
/// <remarks>
/// Usage of the ExecuteDevToolsMethodAsync function does not require an active
/// DevTools front-end or remote-debugging session. Other active DevTools sessions
/// will continue to function independently. However, any modification of global
/// browser state by one session may not be reflected in the UI of other sessions.
/// <para/>
/// Communication with the DevTools front-end (when displayed) can be logged
/// for development purposes by passing the `--devtools-protocol-log-
/// file=<path>` command-line flag.
/// </remarks>
public static async Task<T> ExecuteDevToolsMethodAsync<T>(this IChromiumWebView webview, string method, CefDictionaryValue parameters, ConvertUtf8BufferToTypeDelegate<T> convert, CancellationToken cancellationToken)
where T : class
{
if (webview is null)
throw new ArgumentNullException(nameof(webview));
if (method is null)
throw new ArgumentNullException(nameof(method));
method = method.Trim();
if (method.Length == 0)
throw new ArgumentOutOfRangeException(nameof(method));
object result = await ExecuteDevToolsMethodInternalAsync(webview, method, parameters, (buffer, size) => convert(buffer, size), cancellationToken).ConfigureAwait(false);
return (T)result;
}
