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.WinForms
Assembly: CefSharp.WinForms (in CefSharp.WinForms.dll) Version: 129.0.110.0 (129.0.110.0)

Syntax

C++

Copy

public Task<WaitForNavigationAsyncResponse> WaitForNavigationAsync(
	TimeSpan? timeout = null,
	CancellationToken cancellationToken = default
)

public:
virtual Task<WaitForNavigationAsyncResponse^>^ WaitForNavigationAsync(
	Nullable<TimeSpan> timeout = nullptr, 
	CancellationToken cancellationToken = CancellationToken()
) sealed

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

Copy

string script = "document.getElementsByTagName('a')[0].click();";
await Task.WhenAll(
    chromiumWebBrowser.WaitForNavigationAsync(),
    chromiumWebBrowser.EvaluateScriptAsync(jsScript3));

Reference

ChromiumWebBrowser Class

CefSharp.WinForms Namespace