A long-lived browser session.

Each Rover.Browser owns one rover_runtime OS process. The subprocess in turn owns exactly one Servo instance and one WebView — so one browser = one isolated rendering context with its own proxy, cookies, and network state.

Call start_link/1 to open a browser, then drive it with the functions in the top-level Rover module:

{:ok, browser} = Rover.Browser.start_link(proxy: "http://proxy:8080")
:ok = Rover.navigate(browser, "https://example.com")
{:ok, html} = Rover.content(browser)
Rover.stop(browser)

The process is meant to be added to your own supervisor. If you just need a page's rendered HTML, reach for Rover.fetch/2 — it spins a browser up, runs your operation, and tears it down.

Lifecycle

• start_link/1 blocks until the runtime reports Hello and accepts its Init. A failed init returns {:error, %Rover.Error{}} — the GenServer does not start.
• If the runtime subprocess crashes, the GenServer exits with reason {:port_died, details} and pending callers receive {:error, %Rover.Error{reason: :port_died}}. Use a supervisor to restart the browser.