devbrowser

README

devbrowser

A lightweight Go library for launching and controlling web browsers programmatically, designed for automation and development tools.

Usage

The main entry point is the New function, which creates a new browser controller:

import "github.com/cdvelop/devbrowser"

type myServerConfig struct{}
func (myServerConfig) GetServerPort() string { return "8080" }

type myUI struct{}
func (myUI) ReturnFocus() {}

func main() {
	exitChan := make(chan bool)
	browser := devbrowser.New(myServerConfig{}, myUI{}, exitChan)
	err := browser.OpenBrowser()
	if err != nil {
		// handle error
	}
	// ... use browser ...
	browser.CloseBrowser()
}

Public API

• New(sc serverConfig, ui userInterface, exitChan chan bool) *DevBrowser: Create a new DevBrowser instance.
• (*DevBrowser) OpenBrowser() error: Launch a new browser window.
• (*DevBrowser) CloseBrowser() error: Close the browser and clean up resources.
• (*DevBrowser) Reload() error: Reload the current page in the browser.
• (*DevBrowser) RestartBrowser() error: Restart the browser (close and reopen).
• (*DevBrowser) BrowserStartUrlChanged(fieldName, oldValue, newValue string) error: Handle changes to the start URL and restart the browser if open.
• (*DevBrowser) BrowserPositionAndSizeChanged(fieldName, oldValue, newValue string) error: Change the browser window's position and size, and restart the browser.
• (*DevBrowser) Name() string and (*DevBrowser) Label() string: For UI integration, returns the component name and label.
• (*DevBrowser) Execute(progress func(msgs ...any)): For UI integration, toggles browser open/close and reports progress.

Documentation

Index

• type DevBrowser
  • func New(sc serverConfig, ui userInterface, exitChan chan bool) *DevBrowser
  • func (h *DevBrowser) BrowserPositionAndSizeChanged(fieldName string, oldValue, newValue string) error
  • func (h *DevBrowser) BrowserStartUrlChanged(fieldName string, oldValue, newValue string) error
  • func (h *DevBrowser) CloseBrowser() error
  • func (h *DevBrowser) CreateBrowserContext() error
  • func (h *DevBrowser) Execute(progress func(msgs ...any))
  • func (h *DevBrowser) Label() string
  • func (h *DevBrowser) Name() string
  • func (h *DevBrowser) OpenBrowser() error
  • func (b *DevBrowser) Reload() (err error)
  • func (h *DevBrowser) RestartBrowser() error

Types

type DevBrowser

type DevBrowser struct {
	context.Context    // Este campo no se codificará en YAML
	context.CancelFunc // Este campo no se codificará en YAML
	// contains filtered or unexported fields
}

func New

func New(sc serverConfig, ui userInterface, exitChan chan bool) *DevBrowser

func (*DevBrowser) BrowserPositionAndSizeChanged

func (h *DevBrowser) BrowserPositionAndSizeChanged(fieldName string, oldValue, newValue string) error

func (*DevBrowser) BrowserStartUrlChanged

func (h *DevBrowser) BrowserStartUrlChanged(fieldName string, oldValue, newValue string) error

func (*DevBrowser) CloseBrowser

func (h *DevBrowser) CloseBrowser() error

func (*DevBrowser) CreateBrowserContext

func (h *DevBrowser) CreateBrowserContext() error

func (*DevBrowser) Execute

func (h *DevBrowser) Execute(progress func(msgs ...any))

func (*DevBrowser) Label

func (h *DevBrowser) Label() string

func (*DevBrowser) Name

func (h *DevBrowser) Name() string

func (*DevBrowser) OpenBrowser

func (h *DevBrowser) OpenBrowser() error

func (*DevBrowser) Reload

func (b *DevBrowser) Reload() (err error)

func (*DevBrowser) RestartBrowser

func (h *DevBrowser) RestartBrowser() error