Virgil df0d10b880 docs(api): add exported contract matrix

Add a markdown inventory of every exported type, function, and method with its current signature, a concise description, and test coverage notes based on webview_test.go.

Co-Authored-By: Virgil <virgil@lethean.io>

2026-03-23 15:27:05 +00:00

1.9 KiB

Raw Permalink Blame History

go-webview

Chrome DevTools Protocol (CDP) client for browser automation, testing, and scraping. Connects to an externally managed Chrome or Chromium instance running with --remote-debugging-port=9222, providing navigation, DOM queries, click and type actions, console capture, JavaScript evaluation, screenshots, multi-tab support, viewport emulation, and a fluent ActionSequence builder. Includes Angular-specific helpers for Zone.js stability, router navigation, component introspection, and ngModel access.

Module: dappco.re/go/core/webview Licence: EUPL-1.2 Language: Go 1.25

Quick Start

import "dappco.re/go/core/webview"

wv, err := webview.New(webview.WithDebugURL("http://localhost:9222"))
defer wv.Close()

wv.Navigate("https://example.com")
wv.Click("#submit")
wv.Type("#input", "search term")
png, err := wv.Screenshot()

// Fluent action sequence
err = webview.NewActionSequence().
    Navigate("https://example.com").
    WaitForSelector("#login-form").
    Type("#email", "user@example.com").
    Click("#submit").
    Execute(ctx, wv)

Documentation

API Contract — exported API inventory with signatures and current test coverage
Architecture — CDP connection, DOM queries, console capture, Angular helpers, action system
Development Guide — prerequisites, build, test patterns, adding actions
Project History — completed phases, known limitations, future considerations

Build & Test

go test ./...
go vet ./...
go build ./...

Licence

European Union Public Licence 1.2 — see LICENCE for details.