core/dev.kdriver.core.browser/Browser

Browser

Represents a browser instance that can be controlled programmatically.

This class provides methods to start the browser, navigate to URLs, manage tabs, and handle browser events.

You can create a new instance of this class using the createBrowser method:

fun main() = runBlocking {
    val browser = createBrowser(this)
    // Use the browser instance to do things...
    browser.stop()
}

Inheritors

DefaultBrowser

Properties

config

abstract val config: Config

The configuration for the browser instance.

connection

abstract val connection: Connection?

The connection to the browser's WebSocket debugger.

info

abstract val info: ContraDict?

mainTab

abstract val mainTab: Tab?

The main tab of the browser.

stopped

abstract val stopped: Boolean

Checks if the browser process has stopped.

tabs

abstract val tabs: List<Tab>

A list of all tabs in the browser.

targets

abstract val targets: MutableList<Connection>

A list of targets currently open in the browser.

websocketUrl

abstract val websocketUrl: String

The WebSocket URL for the browser's debugger.

Functions

cleanupTemporaryProfile

abstract suspend fun cleanupTemporaryProfile()

get

abstract suspend fun get(url: String = "about:blank", newTab: Boolean = false, newWindow: Boolean = false): Tab

Top level get. Uses the first tab to retrieve given url.

start

abstract suspend fun start(): Browser

Launches the actual browser

stop

abstract suspend fun stop()

Stops the browser process and cleans up resources.

testConnection

abstract suspend fun testConnection(): Boolean

Tests the connection to the browser by sending a request to the "version" endpoint.

updateTargets

abstract suspend fun updateTargets()

Updates the list of targets in the browser.

wait

abstract suspend fun wait(timeout: Long = 1000): Browser

Waits for the specified time in seconds.