Chrome DevTools Protocol client for browser automation
Find a file
Snider ebdfb38e35
All checks were successful
Security Scan / security (push) Successful in 7s
Test / test (push) Successful in 1m15s
chore: remove boilerplate Taskfile
All tasks (test, build, lint, fmt, vet, cov) are handled natively
by `core go` commands. Taskfile was redundant wrapper.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 14:45:50 +00:00
.forgejo/workflows ci: add Forgejo Actions test and security scan workflows 2026-02-23 03:28:08 +00:00
docs docs: graduate TODO/FINDINGS into production documentation 2026-02-20 15:01:55 +00:00
.editorconfig chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:50 +00:00
.golangci.yml chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:50 +00:00
actions.go refactor: apply go fix modernizers for Go 1.26 2026-02-22 21:00:17 +00:00
angular.go refactor: apply go fix modernizers for Go 1.26 2026-02-22 21:00:17 +00:00
cdp.go feat: modernise to Go 1.26 iterators and stdlib helpers 2026-02-23 05:26:44 +00:00
CLAUDE.md docs: graduate TODO/FINDINGS into production documentation 2026-02-20 15:01:55 +00:00
console.go feat: modernise to Go 1.26 iterators and stdlib helpers 2026-02-23 05:26:44 +00:00
CONTRIBUTING.md chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:50 +00:00
go.mod chore: bump go directive to 1.26.0 2026-02-22 20:33:49 +00:00
go.sum fix: add gorilla/websocket dependency 2026-02-19 16:10:05 +00:00
README.md chore: add Go repo norms (badges, contributing, lint, taskfile, editorconfig) 2026-02-23 06:45:50 +00:00
webview.go feat: modernise to Go 1.26 iterators and stdlib helpers 2026-02-23 05:26:44 +00:00
webview_test.go feat: extract go-webview from core/go pkg/webview 2026-02-19 16:09:11 +00:00

Go Reference License: EUPL-1.2 Go Version

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: forge.lthn.ai/core/go-webview Licence: EUPL-1.2 Language: Go 1.25

Quick Start

import "forge.lthn.ai/core/go-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

  • 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.