WebBrowserExtensionsEvaluateScriptAsPromiseAsync Method (IFrame, String, NullableTimeSpan, String) |
Version 100.0.140
Evaluate Javascript in the context of this Browsers Main Frame. 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: 100.0.140.0 (100.0.140.0)
Syntax public static Task<JavascriptResponse> EvaluateScriptAsPromiseAsync(
this IFrame frame,
string script,
TimeSpan? timeout = null,
string javascriptBindingApiGlobalObjectName = null
)
public:
[ExtensionAttribute]
static Task<JavascriptResponse^>^ EvaluateScriptAsPromiseAsync(
IFrame^ frame,
String^ script,
Nullable<TimeSpan> timeout = nullptr,
String^ javascriptBindingApiGlobalObjectName = nullptr
)
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. - javascriptBindingApiGlobalObjectName (Optional)
- Type: SystemString
Only required if a custom value was specified for JavascriptBindingApiGlobalObjectName
then this param must match that value. Otherwise exclude passing a value for this param or pass in null.
Return Value
Type:
TaskJavascriptResponseTaskTResult 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 See Also