Click or drag to resize

WebBrowserExtensionsEvaluateScriptAsPromiseAsync Method (IFrame, String, NullableTimeSpan)

Version 87.1.132
Evaluate some Javascript code in the context of the MainFrame of the ChromiumWebBrowser. The script will be executed asynchronously and the method returns a Task encapsulating the response from the Javascript. The result of the script execution in javascript is Promise.resolve so even no promise values will be treated as a promise. Your javascript should return a value. The javascript will be wrapped in an Immediately Invoked Function Expression. When the promise either trigger then/catch this returned Task will be completed.

Namespace:  CefSharp
Assembly:  CefSharp (in CefSharp.dll) Version: 87.1.132.0 (87.1.132.0)
Syntax
public static Task<JavascriptResponse> EvaluateScriptAsPromiseAsync(
	this IFrame frame,
	string script,
	Nullable<TimeSpan> timeout = null
)

Parameters

frame
Type: CefSharpIFrame
The instance this method extends.
script
Type: SystemString
The Javascript code that should be executed.
timeout (Optional)
Type: SystemNullableTimeSpan
(Optional) The timeout after which the Javascript code execution should be aborted.

Return Value

Type: TaskJavascriptResponse
TaskTResult that can be awaited to perform the script execution.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IFrame. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptionThrown when one or more arguments are outside the required range.
See Also