browser

package

Go to main page

Versions in this module

v0

v0.4.4

Apr 13, 2026

v0.4.3

Apr 13, 2026

v0.4.2

Apr 12, 2026

Changes in this version

+ func ClickTargetByBackendNodeID(ctx context.Context, debugURL, targetID string, ...) error

+ func FillTargetByBackendNodeID(ctx context.Context, debugURL, targetID string, ...) error

+ func SelectTargetByBackendNodeID(ctx context.Context, debugURL, targetID string, ...) error

+ func TypeTargetByBackendNodeID(ctx context.Context, debugURL, targetID string, ...) error

+ type FillInput struct

+ Target string

+ Value string

type Manager

+ func (m *Manager) ClickElement(ctx context.Context, sessionName, tabName, arg string) error

+ func (m *Manager) FillElements(ctx context.Context, sessionName, tabName string, inputs []FillInput, ...) error

+ func (m *Manager) SelectElement(ctx context.Context, sessionName, tabName, arg, value string) error

+ func (m *Manager) Snapshot(ctx context.Context, sessionName string, tabName string, opts SnapshotOptions) (*SnapshotResult, error)

+ func (m *Manager) TypeElement(ctx context.Context, sessionName, tabName, arg, text string) error

+ type SnapshotNode struct

+ Children []int

+ Description string

+ Name string

+ Ref string

+ Role string

+ States []string

+ Value string

+ type SnapshotOptions struct

+ Depth int64

+ InteractiveOnly bool

+ Mode string

+ Selector string

+ type SnapshotRef struct

+ AXNodeID string

+ BackendDOMNodeID int64

+ FrameID string

+ Name string

+ Ref string

+ Role string

+ SelectorHint string

+ type SnapshotResult struct

+ DocumentKey string

+ GeneratedAt time.Time

+ Mode string

+ Nodes []SnapshotNode

+ Refs []SnapshotRef

+ Title string

+ URL string

+ func SnapshotTarget(ctx context.Context, debugURL, targetID string, opts SnapshotOptions) (*SnapshotResult, error)

v0.4.1

Apr 9, 2026

v0.4.0

Apr 9, 2026

Changes in this version

+ const AttachStateAttachedReady

+ const AttachStateAttachedStale

+ const AttachStateDetached

+ const DefaultProxyListenAddr

+ var ErrDefaultContextInvalid = errors.New("default browser context is invalid")

+ var ErrDefaultContextNotSet = errors.New("default browser context is not set")

+ func DiscoverUserChromeDebugURL() (string, string, error)

+ func GenerateOwnershipToken() (string, error)

+ func IsListenAddrInUse(err error) bool

+ func ProxyEndpointForListenAddr(listenAddr string) string

+ func ProxyHTTPBaseForListenAddr(listenAddr string) string

+ func ResolveDebugURL(ctx context.Context, endpoint string) (string, error)

+ func ResolveDebugURLFromDevToolsFile(path string) (string, error)

+ func ResolveElectronDebugURL(ctx context.Context, port int) (string, error)

+ func ShouldReuseProxyDaemon(record *ProxyDaemonRecord, discoveredUpstreamWSURL string, ...) bool

+ func ShutdownProxyDaemon(ctx context.Context, record *ProxyDaemonRecord) error

+ func WaitForProxyDaemonExit(ctx context.Context, record *ProxyDaemonRecord) error

+ type DefaultContextKind string

+ const DefaultContextAttached

+ const DefaultContextManaged

+ type DefaultContextRecord struct

+ Kind DefaultContextKind

+ Reason string

+ SessionName string

+ Stale bool

+ UpdatedAt time.Time

+ type ElectronProcess struct

+ Name string

+ PID int

+ Port int

+ func ScanElectronProcesses(ctx context.Context) ([]ElectronProcess, error)

type Manager

+ func (m *Manager) AdoptTab(ctx context.Context, sessionName string, tabName string, targetID string, ...) error

+ func (m *Manager) ClearDefaultContext(_ context.Context) error

+ func (m *Manager) DefaultContext(_ context.Context) (*DefaultContextRecord, error)

+ func (m *Manager) SetDefaultContext(_ context.Context, sessionName string, kind DefaultContextKind) error

type ProcessRecord

+ func LaunchElectronApp(ctx context.Context, binaryPath string, extra []string) (*ProcessRecord, error)

+ type Proxy struct

+ func NewProxy(cfg ProxyConfig) *Proxy

+ func (p *Proxy) Serve(ctx context.Context) error

+ func (p *Proxy) ServeListener(ctx context.Context, ln net.Listener) error

+ type ProxyConfig struct

+ ListenAddr string

+ OwnershipToken string

+ Upstream string

+ type ProxyDaemonHealth struct

+ CheckedAt time.Time

+ DaemonReachable bool

+ Healthy bool

+ PIDAlive bool

+ Reason string

+ Status string

+ UpstreamReachable bool

+ func CheckProxyDaemon(ctx context.Context, record *ProxyDaemonRecord) ProxyDaemonHealth

+ func WaitForProxyDaemonHealth(ctx context.Context, record *ProxyDaemonRecord) (ProxyDaemonHealth, error)

+ type ProxyDaemonRecord struct

+ Endpoint string

+ LastError string

+ LastHealthCheckAt time.Time

+ LastHealthyAt time.Time

+ ListenAddr string

+ OwnershipToken string

+ PID int

+ StartedAt time.Time

+ State string

+ Status string

+ UpdatedAt time.Time

+ UpstreamWSURL string

type State

+ DefaultContext *DefaultContextRecord

+ ProxyDaemon *ProxyDaemonRecord

+ func (s *State) ClearDefaultContext()

+ func (s *State) MarkDefaultContextHealthy(sessionName string, now time.Time)

+ func (s *State) MarkDefaultContextStale(sessionName string, reason string, now time.Time)

+ func (s *State) ResolveSessionByPreference(name string) (*SessionRecord, error)

+ func (s *State) SetDefaultContext(sessionName string, kind DefaultContextKind, now time.Time) error

type TargetInfo

+ func ListTargetsHTTP(ctx context.Context, debugURL string) ([]TargetInfo, error)

v0.3.3

Apr 6, 2026

v0.3.2

Apr 6, 2026

Changes in this version

+ const DefaultSessionName

+ type ChromeInfo struct

+ Path string

+ Version string

+ func DetectChrome() *ChromeInfo

type Lightpanda

+ func (lp *Lightpanda) Installed() bool

+ func (lp *Lightpanda) ReadMeta() (*Meta, error)

+ func (lp *Lightpanda) Update(ctx context.Context) error

+ type Meta struct

+ DownloadedAt time.Time

+ URL string

v0.3.1

Apr 4, 2026

v0.3.0

Apr 3, 2026

Changes in this version

+ func BackTarget(ctx context.Context, debugURL string, targetID string) error

+ func ClearCookiesTarget(ctx context.Context, debugURL string, targetID string) error

+ func ClickTarget(ctx context.Context, debugURL string, targetID string, sel string) error

+ func DialogTarget(ctx context.Context, debugURL string, targetID string, accept bool, ...) error

+ func ForwardTarget(ctx context.Context, debugURL string, targetID string) error

+ func GetHTMLTarget(ctx context.Context, debugURL string, targetID string, sel string) (string, string, error)

+ func HoverTarget(ctx context.Context, debugURL string, targetID string, sel string) error

+ func KeypressTarget(ctx context.Context, debugURL string, targetID string, keys string) error

+ func PDFTarget(ctx context.Context, debugURL string, targetID string, landscape bool, ...) ([]byte, error)

+ func ReloadTarget(ctx context.Context, debugURL string, targetID string) error

+ func ScrollTarget(ctx context.Context, debugURL string, targetID string, sel string, ...) error

+ func SelectTarget(ctx context.Context, debugURL string, targetID string, sel string, ...) error

+ func SetCookieTarget(ctx context.Context, debugURL string, targetID string, ...) error

+ func TypeTarget(ctx context.Context, debugURL string, targetID string, sel string, text string) error

+ func WaitForTarget(ctx context.Context, debugURL string, targetID string, sel string, ...) error

+ type CookieEntry struct

+ Domain string

+ Expires float64

+ HTTPOnly bool

+ Name string

+ Path string

+ SameSite string

+ Secure bool

+ Session bool

+ Value string

+ func GetCookiesTarget(ctx context.Context, debugURL string, targetID string) ([]CookieEntry, error)

type Manager

+ func (m *Manager) Back(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) ClearCookies(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) Click(ctx context.Context, sessionName string, tabName string, sel string) error

+ func (m *Manager) Dialog(ctx context.Context, sessionName string, tabName string, accept bool, ...) error

+ func (m *Manager) Forward(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) GetCookies(ctx context.Context, sessionName string, tabName string) ([]CookieEntry, error)

+ func (m *Manager) Hover(ctx context.Context, sessionName string, tabName string, sel string) error

+ func (m *Manager) Keypress(ctx context.Context, sessionName string, tabName string, keys string) error

+ func (m *Manager) PDF(ctx context.Context, sessionName string, tabName string, landscape bool, ...) (*PDFResult, error)

+ func (m *Manager) Reload(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) ResolveTarget(sessionName string, tabName string) (ResolvedTarget, error)

+ func (m *Manager) Scroll(ctx context.Context, sessionName string, tabName string, sel string, ...) error

+ func (m *Manager) Select(ctx context.Context, sessionName string, tabName string, sel string, ...) error

+ func (m *Manager) SetCookie(ctx context.Context, sessionName string, tabName string, ...) error

+ func (m *Manager) Type(ctx context.Context, sessionName string, tabName string, sel string, ...) error

+ func (m *Manager) WaitFor(ctx context.Context, sessionName string, tabName string, sel string, ...) error

+ type PDFResult struct

+ Data []byte

+ SessionName string

+ TabName string

+ type ResolvedTarget = resolvedTarget

v0.2.0

Apr 2, 2026

Changes in this version

+ func ClearIntercept(ctx context.Context, debugURL string, targetID string) error

+ func EnableNetworkLog(ctx context.Context, debugURL string, targetID string, filter NetworkFilter) (<-chan NetworkEntry, func(), error)

+ func GetResponseBody(ctx context.Context, debugURL string, targetID string, requestID string) ([]byte, error)

+ func SetInterceptRules(ctx context.Context, debugURL string, targetID string, rules []InterceptRule) (func(), error)

+ func ValidateInterceptRules(rules []InterceptRule) error

+ type InterceptRule struct

+ AddHeaders map[string]string

+ Block bool

+ Filter NetworkFilter

+ MockBody string

+ MockHeaders map[string]string

+ MockStatus int

type Manager

+ func (m *Manager) NetworkClearIntercept(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) NetworkGetBody(ctx context.Context, sessionName string, tabName string, requestID string) ([]byte, error)

+ func (m *Manager) NetworkIntercept(ctx context.Context, sessionName string, tabName string, rules []InterceptRule) error

+ func (m *Manager) NetworkLog(ctx context.Context, sessionName string, tabName string, filter NetworkFilter) (<-chan NetworkEntry, func(), error)

+ func (m *Manager) NetworkWait(ctx context.Context, sessionName string, tabName string, filter NetworkFilter, ...) (*NetworkEntry, error)

+ type NetworkEntry struct

+ Body string

+ Error string

+ MIMEType string

+ Method string

+ ReqHeaders map[string]string

+ RequestID string

+ ResHeaders map[string]string

+ ResourceType string

+ Status int64

+ Timestamp time.Time

+ URL string

+ func WaitForRequest(ctx context.Context, debugURL string, targetID string, filter NetworkFilter, ...) (*NetworkEntry, error)

+ type NetworkFilter struct

+ Methods []string

+ ResourceTypes []string

+ URLPattern string

v0.1.8

Apr 2, 2026

Changes in this version

+ func CheckProcess(record *ProcessRecord) error — windows/amd64

+ func CheckProcessContext(ctx context.Context, record *ProcessRecord) error — windows/amd64

+ func KillProcess(record *ProcessRecord) error — windows/amd64

+ type Manager struct — windows/amd64

+ func NewManager(store *Store) *Manager

+ func (m *Manager) CloseSession(_ context.Context, name string) error

+ func (m *Manager) CloseTab(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) CreateSession(ctx context.Context, name string, mode Mode, opts SessionOptions) error

+ func (m *Manager) CreateTab(ctx context.Context, sessionName string, tabName string, url string) error

+ func (m *Manager) Evaluate(ctx context.Context, sessionName string, tabName string, js string) (any, error)

+ func (m *Manager) Fill(ctx context.Context, sessionName string, tabName string, fields []FillField, ...) error

+ func (m *Manager) Forms(ctx context.Context, sessionName string, tabName string) ([]FormField, error)

+ func (m *Manager) GetSession(_ context.Context, name string) (*SessionRecord, error)

+ func (m *Manager) ListSessions(_ context.Context) (*SessionList, error)

+ func (m *Manager) ListTabs(_ context.Context, sessionName string) (*TabList, error)

+ func (m *Manager) Navigate(ctx context.Context, sessionName string, tabName string, url string) error

+ func (m *Manager) Reconcile(ctx context.Context, sessionName string) error

+ func (m *Manager) Screenshot(ctx context.Context, sessionName string, tabName string) (*ScreenshotResult, error)

+ func (m *Manager) SelectSession(_ context.Context, name string) error

+ func (m *Manager) SelectTab(_ context.Context, sessionName string, tabName string) error

type ProcessRecord — windows/amd64

+ func LaunchBrowser(ctx context.Context, config LocalConfig) (*ProcessRecord, error)

+ type ScreenshotResult struct — windows/amd64

+ Data []byte

+ SessionName string

+ TabName string

+ type SessionList struct — windows/amd64

+ SelectedSession string

+ Sessions []*SessionRecord

+ type SessionOptions struct — windows/amd64

+ Headless bool

+ WSURL string

+ type TabList struct — windows/amd64

+ SelectedTab string

+ Tabs []*TabRecord

v0.1.7

Apr 2, 2026

Changes in this version

+ const EnvStateRoot

+ const StateVersion

+ const TargetTypePage

+ var ErrAmbiguousSession = errors.New("browser session selection is ambiguous")

+ var ErrAmbiguousTab = errors.New("browser tab selection is ambiguous")

+ var ErrClosedTabSelected = errors.New("browser tab is closed")

+ var ErrNoSessions = errors.New("no browser sessions found")

+ var ErrNoTabs = errors.New("no tracked tabs found")

+ var ErrSessionNotFound = errors.New("browser session not found")

+ var ErrStaleTabSelected = errors.New("browser tab is stale")

+ var ErrTabNotFound = errors.New("browser tab not found")

+ func CapabilitiesForMode(mode Mode) map[Operation]Capability

+ func CheckProcess(record *ProcessRecord) error — darwin/amd64, js/wasm, linux/amd64

+ func CheckProcessContext(ctx context.Context, record *ProcessRecord) error — darwin/amd64, js/wasm, linux/amd64

+ func CloseTarget(ctx context.Context, debugURL string, targetID string) error

+ func CreateTarget(ctx context.Context, debugURL string, url string) (string, error)

+ func DefaultStateRoot() (string, error)

+ func EvalTarget(ctx context.Context, debugURL string, targetID string, js string) (any, error)

+ func FillTarget(ctx context.Context, debugURL string, targetID string, fields []FillField, ...) error

+ func KillProcess(record *ProcessRecord) error — darwin/amd64, js/wasm, linux/amd64

+ func NavigateTarget(ctx context.Context, debugURL string, targetID string, url string) error

+ func ScreenshotTarget(ctx context.Context, debugURL string, targetID string) ([]byte, error)

+ func ValidateSessionName(name string) error

+ func ValidateTabName(name string) error

+ type Capability struct

+ Notes string

+ Supported bool

+ type FillField struct

+ Selector string

+ Value string

+ type FormField struct

+ Disabled bool

+ ID string

+ Label string

+ Name string

+ Placeholder string

+ Required bool

+ Role string

+ Selector string

+ Tag string

+ Type string

+ Value string

+ func FormsTarget(ctx context.Context, debugURL string, targetID string) ([]FormField, error)

+ type LocalConfig struct

+ Headless bool

+ ProfileDir string

+ type Manager struct — darwin/amd64, js/wasm, linux/amd64

+ func NewManager(store *Store) *Manager

+ func (m *Manager) CloseSession(_ context.Context, name string) error

+ func (m *Manager) CloseTab(ctx context.Context, sessionName string, tabName string) error

+ func (m *Manager) CreateSession(ctx context.Context, name string, mode Mode, opts SessionOptions) error

+ func (m *Manager) CreateTab(ctx context.Context, sessionName string, tabName string, url string) error

+ func (m *Manager) Evaluate(ctx context.Context, sessionName string, tabName string, js string) (any, error)

+ func (m *Manager) Fill(ctx context.Context, sessionName string, tabName string, fields []FillField, ...) error

+ func (m *Manager) Forms(ctx context.Context, sessionName string, tabName string) ([]FormField, error)

+ func (m *Manager) GetSession(_ context.Context, name string) (*SessionRecord, error)

+ func (m *Manager) ListSessions(_ context.Context) (*SessionList, error)

+ func (m *Manager) ListTabs(_ context.Context, sessionName string) (*TabList, error)

+ func (m *Manager) Navigate(ctx context.Context, sessionName string, tabName string, url string) error

+ func (m *Manager) Reconcile(ctx context.Context, sessionName string) error

+ func (m *Manager) Screenshot(ctx context.Context, sessionName string, tabName string) (*ScreenshotResult, error)

+ func (m *Manager) SelectSession(_ context.Context, name string) error

+ func (m *Manager) SelectTab(_ context.Context, sessionName string, tabName string) error

+ type Mode string

+ const ModeLocal

+ const ModeRemote

+ type Operation string

+ const OperationEvaluate

+ const OperationNavigate

+ const OperationScreenshot

+ const OperationSessionClose

+ const OperationSessionNew

+ const OperationTabClose

+ const OperationTabNew

+ type ProcessRecord struct

+ DebugURL string

+ OwnershipToken string

+ PID int

+ StartedAt time.Time

+ func LaunchBrowser(ctx context.Context, config LocalConfig) (*ProcessRecord, error)

+ type RemoteConfig struct

+ WSURL string

+ type ScreenshotResult struct — darwin/amd64, js/wasm, linux/amd64

+ Data []byte

+ SessionName string

+ TabName string

+ type SessionList struct — darwin/amd64, js/wasm, linux/amd64

+ SelectedSession string

+ Sessions []*SessionRecord

+ type SessionOptions struct — darwin/amd64, js/wasm, linux/amd64

+ Headless bool

+ WSURL string

+ type SessionRecord struct

+ Capabilities map[Operation]Capability

+ CreatedAt time.Time

+ LastReconciledAt time.Time

+ Local *LocalConfig

+ Mode Mode

+ Name string

+ Process *ProcessRecord

+ Remote *RemoteConfig

+ SelectedTab string

+ Tabs map[string]*TabRecord

+ UpdatedAt time.Time

+ func NewLocalSession(name string, profileDir string, headless bool, now time.Time) (*SessionRecord, error)

+ func NewRemoteSession(name string, wsURL string, now time.Time) (*SessionRecord, error)

+ func (s *SessionRecord) ResolveTab(name string) (*TabRecord, error)

+ type State struct

+ SelectedSession string

+ Sessions map[string]*SessionRecord

+ Version int

+ func NewState() *State

+ func (s *State) CreateSession(session *SessionRecord) error

+ func (s *State) DeleteSession(name string) error

+ func (s *State) DeleteTab(sessionName string, tabName string) error

+ func (s *State) Normalize()

+ func (s *State) ReconcileSession(sessionName string, liveTargetIDs []string, now time.Time) error

+ func (s *State) ResolveSession(name string) (*SessionRecord, error)

+ func (s *State) SelectSession(name string) error

+ func (s *State) SelectTab(sessionName string, tabName string) error

+ func (s *State) UpsertTab(sessionName string, tab *TabRecord) error

+ func (s *State) Validate() error

+ type Store struct

+ func NewStore(root string) (*Store, error)

+ func (s *Store) Load() (*State, error)

+ func (s *Store) Root() string

+ func (s *Store) Save(state *State) error

+ func (s *Store) Update(fn func(*State) error) error

+ func (s *Store) UpdateSession(sessionName string, fn func(*State, *SessionRecord) error) error

+ func (s *Store) WithSessionLock(sessionName string, fn func() error) error

+ type TabList struct — darwin/amd64, js/wasm, linux/amd64

+ SelectedTab string

+ Tabs []*TabRecord

+ type TabRecord struct

+ CreatedAt time.Time

+ LastSeenAt time.Time

+ Name string

+ Status TabStatus

+ TargetID string

+ URL string

+ UpdatedAt time.Time

+ func NewTab(name string, targetID string, url string, now time.Time) (*TabRecord, error)

+ type TabStatus string

+ const TabStatusClosed

+ const TabStatusLive

+ const TabStatusStale

+ type TargetInfo struct

+ TargetID string

+ Title string

+ Type string

+ URL string

+ func ListTargets(ctx context.Context, debugURL string) ([]TargetInfo, error)

v0.1.6

Apr 2, 2026

Changes in this version

+ type Lightpanda struct

+ func NewLightpanda(binDir, port string) *Lightpanda

+ func (lp *Lightpanda) Cleanup() error

+ func (lp *Lightpanda) EnsureInstalled(ctx context.Context) error

+ func (lp *Lightpanda) Running() bool

+ func (lp *Lightpanda) Start(ctx context.Context) error

+ func (lp *Lightpanda) Stop()

+ func (lp *Lightpanda) WSURL() string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL