Click or drag to resize

WebBrowserExtensionsWaitForNavigationAsync Method

Version 107.1.120
This resolves when the browser navigates to a new URL or reloads. It is useful for when you run code which will indirectly cause the browser to navigate. A common use case would be when executing javascript that results in a navigation. e.g. clicks a link This must be called before executing the action that navigates the browser. It may not resolve correctly if called after.

Namespace:  CefSharp
Assembly:  CefSharp (in CefSharp.dll) Version: 107.1.120.0 (107.1.120.0)
Syntax
public static Task<WaitForNavigationAsyncResponse> WaitForNavigationAsync(
	IChromiumWebBrowserBase chromiumWebBrowser,
	TimeSpan? timeout = null,
	CancellationToken cancellationToken = default
)

Parameters

chromiumWebBrowser
Type: CefSharpIChromiumWebBrowserBase
ChromiumWebBrowser instance (cannot be null)
timeout (Optional)
Type: SystemNullableTimeSpan
optional timeout, if not specified defaults to five(5) seconds.
cancellationToken (Optional)
Type: System.ThreadingCancellationToken
optional CancellationToken

Return Value

Type: TaskWaitForNavigationAsyncResponse
Task which resolves when LoadingStateChanged has been called with IsLoading false. or when LoadError is called to signify a load failure.
Remarks
Usage of the History APIhttps://developer.mozilla.org/en-US/docs/Web/API/History_API to change the URL is considered a navigation
Examples
string script = "document.getElementsByTagName('a')[0].click();";
await Task.WhenAll(
    chromiumWebBrowser.WaitForNavigationAsync(),
    chromiumWebBrowser.EvaluateScriptAsync(script));
See Also