WebBrowserExtensionsEvaluateScriptAsync Method (IBrowser, String, NullableTimeSpan, Boolean)

Version 112.3.0

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

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

Syntax

C++

Copy

public static Task<JavascriptResponse> EvaluateScriptAsync(
	this IBrowser browser,
	string script,
	TimeSpan? timeout = null,
	bool useImmediatelyInvokedFuncExpression = false
)

public:
[ExtensionAttribute]
static Task<JavascriptResponse^>^ EvaluateScriptAsync(
	IBrowser^ browser, 
	String^ script, 
	Nullable<TimeSpan> timeout = nullptr, 
	bool useImmediatelyInvokedFuncExpression = false
)

Parameters

browser: Type: CefSharpIBrowser
The IBrowser 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.
useImmediatelyInvokedFuncExpression (Optional): Type: SystemBoolean
When true the script is wrapped in a self executing function. Make sure to use a return statement in your javascript. e.g. (function () { return 42; })(); When false don't include a return statement e.g. 42;

Return Value

Type: TaskJavascriptResponse
TaskTResult that can be awaited to obtain the result of the script execution.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IBrowser. 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.

Reference

WebBrowserExtensions Class

EvaluateScriptAsync Overload

CefSharp Namespace