Click or drag to resize

ChromiumWebBrowserWaitForNavigationAsync Method

Version 130.1.90
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.OffScreen
Assembly: CefSharp.OffScreen (in CefSharp.OffScreen.dll) Version: 129.0.110.0 (129.0.110.0)
Syntax
Copy
public Task<WaitForNavigationAsyncResponse> WaitForNavigationAsync(
	TimeSpan? timeout = null,
	CancellationToken cancellationToken = default
)

Parameters

timeout  NullableTimeSpan  (Optional)
optional timeout, if not specified defaults to five(5) seconds.
cancellationToken  CancellationToken  (Optional)
optional CancellationToken

Return Value

TaskWaitForNavigationAsyncResponse
Task which resolves when LoadingStateChanged has been called with IsLoading false. or when LoadError is called to signify a load failure.

Implements

IChromiumWebBrowserBaseWaitForNavigationAsync(NullableTimeSpan, CancellationToken)
Remarks
Usage of the History APIhttps://developer.mozilla.org/en-US/docs/Web/API/History_API to change the URL is considered a navigation
Example
C#
Copy
string script = "document.getElementsByTagName('a')[0].click();";
await Task.WhenAll(
    chromiumWebBrowser.WaitForNavigationAsync(),
    chromiumWebBrowser.EvaluateScriptAsync(jsScript3));
See Also