WebBrowserExtensionsExEvaluateScriptAsyncT Method (IFrame, String, NullableTimeSpan)

Version 112.3.0

Evaluate javascript code in the context of the frame. The script will be executed asynchronously and the method returns a Task that can be awaited to obtain the result.

Namespace: CefSharp
Assembly: CefSharp.Core (in CefSharp.Core.dll) Version: 112.3.0.0

Syntax

C++

Copy

public static Task<T> EvaluateScriptAsync<T>(
	this IFrame frame,
	string script,
	TimeSpan? timeout = null
)

public:
[ExtensionAttribute]
generic<typename T>
static Task<T>^ EvaluateScriptAsync(
	IFrame^ frame, 
	String^ script, 
	Nullable<TimeSpan> timeout = nullptr
)

Parameters

frame: Type: CefSharpIFrame
The IFrame 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.

Type Parameters

T: Type

Return Value

Type: TaskT
TaskTResult that can be awaited to obtain the result of the script execution. The DefaultBinder is used to convert the result to the desired type. Property names are converted from camelCase. If the script execution returns an error then an exception is thrown.

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

Exception	Condition
ArgumentOutOfRangeException	Thrown when one or more arguments are outside the required range.
Exception	Thrown if a Javascript error occurs.

Reference

WebBrowserExtensionsEx Class

EvaluateScriptAsync Overload

CefSharp Namespace