newBrowser

abstract fun newBrowser(): Browser

Creates a new Browser instance under the default profile and navigates it to the "about:blank" web page within the defaultTimeout.

By default, the browser’s rendering mode matches this engine’s rendering mode configured in EngineOptions. To create a browser with a different mode, use newBrowser.

Return

a new Browser instance

Throws

when the engine failed to create a browser instance within the timeout

when the navigation to the "about:blank" has failed

when the engine is already closed


abstract fun newBrowser(renderingMode: RenderingMode): Browser

Creates a new Browser instance under the default profile and navigates it to the "about:blank" web page within the defaultTimeout with the given renderingMode.

Return

a new Browser instance

Since

9.0.0

Parameters

renderingMode

the rendering mode that indicates how the Browser instance will render the content of the web pages

Throws

when the engine failed to create a browser instance within the timeout

when the navigation to the "about:blank" has failed

when the engine is already closed