⚠️ Work in Progress — APIs are evolving rapidly; backward compatibility is not guaranteed. Android and iOS platforms are not yet fully tested. Current automation capabilities primarily target the Desktop (JVM) platform.

English | 简体中文

KBrowser is a Kotlin Multiplatform library that provides:

1. KBWebView — A cross-platform WebView UI component for Android, iOS, and Desktop (JVM), with a unified API similar to WKWebView / Android WebView.
2. KBPage + KBBrowser — A Playwright-inspired browser automation API for Desktop (JVM), built on Chrome DevTools Protocol (CDP). Supports headless mode, AXTree extraction, CSP-safe element location, anti-detection physical clicks, and screenshot capture.

kotlin multiplatform compose multiplatform webview browser automation playwright CDP chrome devtools protocol JCEF JetBrains CEF headless browser web scraping AXTree accessibility tree KMP CMP desktop automation cross-platform webview kotlin browser kotlin scraper

⚠️ Note: Automation features (such as AXTree, CDP-based physical clicks, and screenshots) are Desktop-only. On Android and iOS, KBLocator falls back to JS injection.

Must use JetBrains Runtime 25 (JBR) with JCEF. Standard JDK will not work.

Distribution: JetBrains Runtime 25
Package: JDK + JCEF

The library does not bundle JCEF. Configure your IDE or build tool to use JBR 25 with JCEF as the project runtime.

• Architecture Design — Coordinate system, platform internals, threading model
• API Reference — All APIs with descriptions and usage examples

Must be called before application {}:

fun main() {
    KBrowser.setConfigPath("/path/to/cache")
    initializeKBrowser()  // Must come before any UI initialization
 
    application {
        Window(onCloseRequest = ::exitApplication) { App() }
    }
}

@Composable
fun BrowserScreen() {
    val webView = rememberKBWebView(initialUrl = "https://example.com")

    LaunchedEffect(webView) {
        // Handle new window requests (e.g. window.open() or target="_blank")
        webView.onNewWindowRequest = { url ->
            webView.loadUrl(url)  // Load in current webview, or open a new KBPage
        }
    }

    Column(Modifier.fillMaxSize()) {
        KBWebView(webView = webView, modifier = Modifier.weight(1f))
        Row {
            Button(onClick = { webView.goBack() }) { Text("←") }
            Button(onClick = { webView.goForward() }) { Text("→") }
            Button(onClick = { webView.reload() }) { Text("↺") }
        }
    }
}

// Runs in headless mode, no UI needed
val page = KBrowser.newPage(url = "https://example.com")

// Intercept new page requests
page.onNewPage = { url -> println("New page request: $url") }

// Navigate and interact
page.loadUrl("https://example.com/login")
page.getByLabel("Username").fill("admin")
page.getByLabel("Password").type("secret")   // Physical key events, anti-detection
page.getByRole("button", name = "Login").click()

// Extract accessibility tree (AXTree)
val tree = page.getRawAxTree().getCleanedAxTree()
println("Visible nodes: ${tree.visibleElements}")

// Screenshot — CSS pixel output, aligned with AXTree coordinates
val png = page.screenshot()

page.close()

Apache License 2.0 — see LICENSE.

Portions of the JVM/Desktop implementation are derived from IntelliJ IDEA (JetBrains s.r.o.), licensed under Apache 2.0. Modified files retain original copyright notices.