Options for how a webview that implements IWithPopups handles popups.




The browser engine automatically creates a new webview for the popup and loads the popup URL into the new webview. The original webview then raises its PopupRequested event and provides the new popup webview as PopupRequestedEventArgs.WebView.

Some authentication flows require this mode in order to function correctly. For example, auth flows like "Sign in with Google" open the signin page in a special popup that can relay the auth result back to the original page after authorization is finished.LoadInNewWebView must be used for flows like this, and the flow can not be emulated with the other popup modes.


The popup URL is automatically loaded into the original webview. This is the default behavior. In this mode, the PopupRequested event isn't raised.


The browser engine doesn't automatically create a new webview for the popup, but it still raises the PopupRequested event with a PopupRequestedEventArgs.WebView of null.