engine

package

Go to main page

Versions in this module

v0

v0.8.0

Apr 29, 2026

Changes in this version

+ var DefaultDiscoverPorts = []int

+ func DiscoverCDP(ports []int, timeout time.Duration) (string, error)

type BrowserOpts

+ AttachFresh bool

v0.7.1

Apr 29, 2026

v0.7.0

Apr 29, 2026

Changes in this version

+ const CookiesJSONFilename

+ var DefaultExtensionNames = []string

+ func ApplyProxyAuth(page *rod.Page, proxyURL string) error

+ func DecryptCookiesInPlace(cookiesPath string) (total, decrypted, failed int, err error)

+ func DefaultExtensionPaths() ([]string, error)

+ func DefaultExtensionsDir() (string, error)

+ func FindSystemChromeBinary() string

+ func HumanMode() bool

+ func InjectCookies(page *rod.Page, cookies []CookieRecord) (int, error)

+ func ProfileUsesSystemChrome(userDataDir string) bool

+ func ResolveProfileDir(name string) (string, error)

+ func SaveCookiesJSON(profileDir string, cookies []CookieRecord) error

+ func SetHumanMode(enabled bool)

type Browser

+ func NewBrowserWith(opts BrowserOpts) (*Browser, error)

+ type BrowserOpts struct

+ ConnectURL string

+ Extensions []string

+ Headless bool

+ Invisible bool

+ Proxy string

+ SystemChrome bool

+ TimeoutSec int

+ UserDataDir string

+ type CaptureSession struct

+ func StartCapture(page *rod.Page, spec CaptureSpec) (*CaptureSession, error)

+ func (s *CaptureSession) Entries() []*CapturedEntry

+ func (s *CaptureSession) ReachedMax() <-chan struct{}

+ func (s *CaptureSession) Stop() ([]*CapturedEntry, error)

+ type CaptureSpec struct

+ IncludeBody bool

+ Max int

+ MimeMatch string

+ OutputPath string

+ URLMatch string

+ type CapturedEntry struct

+ Body string

+ BodyBase64 bool

+ BodyError string

+ Method string

+ MimeType string

+ PostData string

+ ReqHeaders map[string]string

+ RequestID string

+ ResHeaders map[string]string

+ ResourceType string

+ StartedAt string

+ Status int

+ StatusText string

+ URL string

+ type CookieRecord struct

+ Domain string

+ Expires float64

+ HTTPOnly bool

+ Name string

+ Path string

+ SameSite string

+ Secure bool

+ Value string

+ func ExportDecryptedCookies(cookiesPath string) ([]CookieRecord, error)

+ func LoadCookiesJSON(profileDir string) ([]CookieRecord, error)

type ErrorCollector

+ func (c *ErrorCollector) Close()

type LauncherOpts

+ Extensions []string

+ Invisible bool

+ Proxy string

+ SystemChrome bool

+ UserDataDir string

v0.6.1

Apr 20, 2026

v0.6.0

Apr 20, 2026

Changes in this version

+ func ClickElement(page *rod.Page, el *rod.Element) error

+ func HoverElement(page *rod.Page, el *rod.Element) error

+ func ResolveByLocator(page *rod.Page, loc Locator) (*rod.Element, error)

+ func TypeElement(page *rod.Page, el *rod.Element, text string) error

+ type ImageDiffResult struct

+ DiffPath string

+ DiffRatio float64

+ Height int

+ PixelsChanged int

+ PixelsTotal int

+ SkipReason string

+ Skipped bool

+ Width int

+ func DiffImages(baselinePNG, currentPNG []byte, tolerance int, diffPath string) (*ImageDiffResult, error)

+ type Locator struct

+ Label string

+ Name string

+ Role string

+ Text string

+ func (l Locator) IsEmpty() bool

v0.5.0

Apr 20, 2026

Changes in this version

+ func LoadFulfillBody(value string) ([]byte, error)

+ func ParseBlockList(s string) []string

+ func WriteHAR(h *HAR, path string) error

+ type HAR struct

+ Log HARLog

+ func BuildHAR(entries []NetworkEntry, pageURL, pageTitle, creatorVersion string) *HAR

+ type HARContent struct

+ MimeType string

+ Size int

+ type HARCreator struct

+ Name string

+ Version string

+ type HAREntry struct

+ Cache struct{}

+ PageRef string

+ Request HARRequest

+ Response HARResponse

+ StartedDateTime string

+ Time int64

+ Timings HARTimings

+ type HARLog struct

+ Creator HARCreator

+ Entries []HAREntry

+ Pages []HARPage

+ Version string

+ type HARPage struct

+ ID string

+ StartedDateTime string

+ Title string

+ type HARRequest struct

+ BodySize int

+ HTTPVersion string

+ Headers []string

+ HeadersSize int

+ Method string

+ QueryString []string

+ URL string

+ type HARResponse struct

+ BodySize int

+ Content HARContent

+ Cookies []string

+ HTTPVersion string

+ Headers []string

+ HeadersSize int

+ RedirectURL string

+ Status int

+ StatusText string

+ type HARTimings struct

+ Receive int

+ Send int

+ Wait int64

+ type InterceptSession struct

+ func StartIntercept(browser *rod.Browser, spec InterceptSpec) (*InterceptSession, error)

+ func (s *InterceptSession) Stats() *InterceptStats

+ func (s *InterceptSession) Stop() error

+ type InterceptSpec struct

+ BlockPatterns []string

+ FulfillBody []byte

+ FulfillContentType string

+ FulfillPattern string

+ FulfillStatus int

+ type InterceptStats struct

+ Blocked int

+ Fulfilled int

+ Passed int

+ func (s *InterceptStats) Snapshot() (blocked, fulfilled, passed int)

v0.4.0

Apr 20, 2026

Changes in this version

+ func ApplyColorScheme(page *rod.Page, scheme string) error

+ func ApplyDevice(page *rod.Page, d Device) error

+ func ApplyTimezone(page *rod.Page, tz string) error

+ func ApplyUserAgent(page *rod.Page, ua string) error

+ func CountSelector(page *rod.Page, selector string) int

+ func HasSelector(page *rod.Page, selector string) bool

+ func ScrollBy(page *rod.Page, dy int) (int, error)

+ func ScrollToRef(page *rod.Page, ref string, snapshot *PageSnapshot) error

+ func ScrollToY(page *rod.Page, y int, bottomSentinel bool) (int, error)

+ type Device struct

+ DPR float64

+ Height int

+ Mobile bool

+ Name string

+ Touch bool

+ UserAgent string

+ Width int

+ func DeviceByName(name string) (Device, bool)

+ func ListDevices() []Device

v0.3.0

Apr 20, 2026

Changes in this version

+ func LoadStorageState(browser *rod.Browser, page *rod.Page, state *StorageState) error

+ func UploadRef(page *rod.Page, ref string, selector string, files []string, ...) error

+ type StorageCookie struct

+ Domain string

+ Expires float64

+ HTTPOnly bool

+ Name string

+ Path string

+ SameSite string

+ Secure bool

+ Value string

+ type StorageKeyValue struct

+ Name string

+ Value string

+ type StorageOrigin struct

+ LocalStorage []StorageKeyValue

+ Origin string

+ type StorageState struct

+ Cookies []StorageCookie

+ Origins []StorageOrigin

+ func SaveStorageState(browser *rod.Browser, page *rod.Page) (*StorageState, error)

v0.2.0

Apr 20, 2026

Changes in this version

+ var ErrStaleRef = errors.New("stale ref: snapshot is missing or no longer matches the page")

+ func DetectAgent() bool

+ func FormatCollect(r *CollectResult) string

+ func FormatDiff(d SnapshotDiff) string

+ func FormatMultiCollect(r *MultiCollectResult) string

+ func FormatPreviewProfile(r *PreviewResult, p RenderProfile) string

+ func FormatTextProfile(result *ExtractionResult, p RenderProfile) string

+ func NewLauncher(opts LauncherOpts) *launcher.Launcher

+ func TruncateURL(u string, maxLen int) string

+ func ValidateExtractLevel(level ExtractLevel) error

+ func WaitForBotChallenge(page *rod.Page, timeout time.Duration) bool

+ func WaitForPage(page *rod.Page, waitStrategy string) error

type Browser

+ func (b *Browser) CurrentTargetID() string

+ func (b *Browser) DeleteSnapshot(targetID proto.TargetTargetID) error

+ func (b *Browser) RodBrowser() *rod.Browser

+ func (b *Browser) SaveSnapshot(page *rod.Page, result *ExtractionResult) error

+ func (b *Browser) SetCurrentPage(page *rod.Page) error

+ func (b *Browser) Snapshot(page *rod.Page) *PageSnapshot

+ type CollectResult struct

+ ItemCount int

+ Items []CollectedItem

+ PageURL string

+ func Collect(page *rod.Page, limit int) (*CollectResult, error)

+ type CollectedItem struct

+ Fields map[string]string

+ Price string

+ Title string

+ URL string

+ type DialogResult struct

+ Action string

+ DefaultPrompt string

+ Handled bool

+ Message string

+ TimedOut bool

+ Type string

+ URL string

+ type DiffEntry struct

+ After DiffNode

+ Before DiffNode

+ type DiffNode struct

+ Href string

+ Name string

+ Ref string

+ Role string

+ Value string

+ type DiffStats struct

+ AddedCount int

+ ChangedCount int

+ KeptCount int

+ RemovedCount int

type ErrorEntry

+ func CollectErrors(page *rod.Page, url string, waitStrategy string, ...) ([]ErrorEntry, error)

type ExtractedNode

+ BackendNodeID proto.DOMBackendNodeID

+ type LauncherOpts struct

+ Headless bool

+ RemotePort int

+ type MultiCollectResult struct

+ Sites []SiteResult

+ TotalItems int

+ TotalTimeMs int64

+ func MultiCollect(browser *rod.Browser, urls []string, limit int, stealth bool, maxParallel int) *MultiCollectResult

type NetworkEntry

+ Error string

+ type PageSnapshot struct

+ Refs map[string]RefSnapshot

+ TargetID string

+ Title string

+ URL string

+ func BuildSnapshot(page *rod.Page, result *ExtractionResult) (*PageSnapshot, error)

+ type RefSnapshot struct

+ BackendNodeID proto.DOMBackendNodeID

+ Name string

+ Role string

+ type RenderProfile struct

+ AbbrevRoles bool

+ Agent bool

+ DropEmptyStats bool

+ Format string

+ MaxLabelLen int

+ func ProfileAgent(format string) RenderProfile

+ func ProfileHuman(format string) RenderProfile

+ func ResolveProfile(explicit, format string) RenderProfile

+ type SiteResult struct

+ Count int

+ Error string

+ Items []CollectedItem

+ TimeMs int64

+ URL string

+ type SnapshotDiff struct

+ Added []DiffNode

+ Changed map[string]DiffEntry

+ Removed []string

+ Stats DiffStats

+ Unchanged bool

+ func DiffRefs(prev, curr map[string]RefSnapshot) SnapshotDiff

type TabInfo

+ Active bool

+ TargetID string

v0.1.0

Apr 3, 2026

Changes in this version

+ func ApplyStealth(page *rod.Page) error

+ func ClickRef(page *rod.Page, ref string) error

+ func CloseTab(browser *rod.Browser, index int) error

+ func DismissCookieBanner(page *rod.Page) bool

+ func EvalJS(page *rod.Page, expr string, elementRef string) (string, error)

+ func FormatErrors(errors []ErrorEntry) string

+ func FormatPreview(r *PreviewResult) string

+ func FormatText(result *ExtractionResult) string

+ func HandleNextDialog(page *rod.Page, accept bool, promptText string)

+ func HoverRef(page *rod.Page, ref string) error

+ func PressKey(page *rod.Page, key string, ref string) error

+ func ResolveRef(page *rod.Page, ref string) (*rod.Element, error)

+ func SelectOption(page *rod.Page, ref string, values []string) error

+ func SetViewport(page *rod.Page, width, height int) error

+ func SwitchTab(browser *rod.Browser, index int) (*rod.Page, error)

+ func TakeScreenshot(page *rod.Page, fullPage bool, elementRef string, quality int) ([]byte, error)

+ func TypeRef(page *rod.Page, ref string, text string) error

+ func WaitForSelector(page *rod.Page, selector string, timeoutSec int) error

+ type Browser struct

+ func NewBrowser(connectURL string, headless bool, timeoutSec int) (*Browser, error)

+ func (b *Browser) Close()

+ func (b *Browser) Connected() bool

+ func (b *Browser) Page() (*rod.Page, error)

+ func (b *Browser) RawBrowser() *rod.Browser

+ type ErrorCollector struct

+ func NewErrorCollector(page *rod.Page) *ErrorCollector

+ func (c *ErrorCollector) Errors() []ErrorEntry

+ type ErrorEntry struct

+ Level string

+ Message string

+ Method string

+ Source string

+ Status int

+ TimeMs int64

+ Type string

+ type ExtractLevel string

+ const LevelContent

+ const LevelFull

+ const LevelSkeleton

+ type ExtractedNode struct

+ Checked *bool

+ Children []ExtractedNode

+ Disabled bool

+ Href string

+ Level int

+ Name string

+ Ref string

+ Role string

+ Type string

+ Value string

+ type ExtractionResult struct

+ Nodes []ExtractedNode

+ Refs map[string]ExtractedNode

+ Stats ExtractionStats

+ func Extract(page *rod.Page, level ExtractLevel, selector string) (*ExtractionResult, error)

+ type ExtractionStats struct

+ FilteredNodes int

+ InteractiveCount int

+ TotalNodes int

+ type NetworkEntry struct

+ Method string

+ MimeType string

+ Size int

+ Status int

+ TimeMs int64

+ URL string

+ type PageInfo struct

+ Status int

+ TimeMs int64

+ Title string

+ URL string

+ func Navigate(page *rod.Page, rawURL string, waitStrategy string) (*PageInfo, error)

+ type PreviewResult struct

+ DOM *ExtractionResult

+ Errors []ErrorEntry

+ Network []NetworkEntry

+ PageInfo *PageInfo

+ Summary PreviewSummary

+ func Preview(page *rod.Page, url string, waitStrategy string, extractLevel ExtractLevel) (*PreviewResult, error)

+ type PreviewSummary struct

+ ErrorCount int

+ FailedRequests int

+ InteractiveCount int

+ TotalRequests int

+ WarningCount int

+ type TabInfo struct

+ Index int

+ Title string

+ URL string

+ func ListTabs(browser *rod.Browser) ([]TabInfo, error)

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