rod

package module

Go to main page

Versions in this module

v0

v0.127.0

Oct 5, 2026

v0.126.0

Oct 5, 2026

v0.125.0

Sep 26, 2026

Changes in this version

+ const DefaultMaxResponseBodyBytes

+ const DefaultMaxResponseHeaderBytes

+ var ErrAuthCredentials = errors.New("rod: invalid auth credentials")

+ var ErrDownloadGUID = errors.New("rod: download GUID is not a single local file name")

+ var ErrExposedFunctionExited = errors.New("rod: exposed function exited without returning")

+ var ErrHijackHandlerExited = errors.New("rod: hijack handler exited without returning")

+ var ErrInvalidDataURL = errors.New("invalid data URL")

+ var ErrResponseBodyTooLarge = errors.New("rod: hijacked response body exceeds its size limit")

+ var ErrResponseHeadersTooLarge = errors.New("rod: hijacked response headers exceed their size limit")

+ var ErrScrollScreenshotOptions = errors.New("rod: invalid scroll screenshot options")

+ var ErrScrollScreenshotTooTall = errors.New("rod: page content exceeds the scroll screenshot height limit")

+ var ErrUnsupportedDomain = errors.New(...)

+ type AuthCredentials struct

+ AnyOrigin bool

+ Origin string

+ Password string

+ Source proto.FetchAuthChallengeSource

+ Username string

type Browser

+ func (b *Browser) Decoding(mode proto.Decoding) *Browser

+ func (b *Browser) GetDecoding() proto.Decoding

type Element

+ func (el *Element) GetDecoding() proto.Decoding

type Hijack

+ FollowRedirects bool

+ MaxResponseBodyBytes int64

+ MaxResponseHeaderBytes int64

type HijackRouter

+ func (r *HijackRouter) ContinueUnparsableURLs(enabled bool) *HijackRouter

+ func (r *HijackRouter) OnError(fn func(error)) *HijackRouter

type Message

+ func (msg *Message) MustLoad[E proto.Event](out *E) bool

type Page

+ func (p *Page) GetDecoding() proto.Decoding

+ func (p *Page) MustExposeHelpers(list ...*js.Function) *Page

type ScrollScreenshotOptions

+ MaxHeight float64

type StreamReader

+ ChunkSize int

type TraceType

+ const TraceTypeMonitor

v0.124.0

Sep 23, 2026

v0.123.0

Sep 22, 2026

v0.122.0

Sep 22, 2026

Changes in this version

+ var ErrDragEnded = errors.New("drag has ended")

+ var ErrDragInProgress = errors.New("a drag is already in progress")

+ var ErrInvalidDrag = errors.New("invalid drag parameters")

+ type Drag struct

+ func (d *Drag) Cancel() error

+ func (d *Drag) Drop() error

+ func (d *Drag) MoveTo(position proto.Point) error

+ func (d *Drag) MustCancel()

+ func (d *Drag) MustDrop()

+ func (d *Drag) MustMoveTo(position proto.Point) *Drag

type Element

+ func (el *Element) MustSetFilesFromMemory(files ...FilePayload) *Element

+ func (el *Element) SetFilesFromMemory(files []FilePayload) error

+ type FilePayload struct

+ Data []byte

+ MIMEType string

+ Name string

type Page

+ func (p *Page) Drag(position proto.Point, data *proto.InputDragData) (*Drag, error)

+ func (p *Page) MustDrag(position proto.Point, data *proto.InputDragData) *Drag

+ func (p *Page) MustWaitInteractive() *Page

+ func (p *Page) WaitInteractive() error

v0.121.0

Sep 13, 2026

v0.120.0

Sep 6, 2026

Changes in this version

+ var ErrBrowserDisconnected = errors.New("browser connection closed")

+ var ErrCleanupTimeout = errors.New("browser cleanup timeout must be positive")

+ var ErrDiagnosticsIncomplete = errors.New("rod: incomplete page diagnostics")

+ var ErrDiagnosticsOptions = errors.New("rod: invalid diagnostics options")

+ var ErrDownloadCanceled = errors.New("rod: download canceled")

+ var ErrDownloadInProgress = errors.New("rod: a download wait is already active in this browser context")

+ var ErrFrameContextChanged = errors.New("iframe context changed; acquire a new view with Element.Frame")

+ var ErrLaunchConflict = errors.New(...)

type Browser

+ func (b *Browser) CloseWithTimeout(timeout time.Duration) error

+ func (b *Browser) Launch(l *launcher.Launcher) (err error)

+ type ConsoleMessage struct

+ Text string

+ Type proto.RuntimeConsoleAPICalledType

+ type DiagnosticLocation struct

+ Column int

+ Line int

+ URL string

+ type DiagnosticsOptions struct

+ MaxPreviewDepth int

+ MaxRecords int

+ MaxRequests int

+ MaxTextBytes int

+ StopTimeout time.Duration

+ type DiagnosticsSnapshot struct

+ Console []ConsoleMessage

+ DroppedConsole int

+ DroppedPageErrors int

+ DroppedRequests int

+ DroppedResourceFailures int

+ PageErrors []PageError

+ ResourceFailures []ResourceFailure

+ type JSONSerializationError struct

+ Message string

+ func (e *JSONSerializationError) Error() string

type Page

+ func (p *Page) EvalJSON(destination any, js string, args ...any) error

+ func (p *Page) StartDiagnostics(options DiagnosticsOptions) (*PageDiagnostics, error)

+ type PageDiagnostics struct

+ func (d *PageDiagnostics) Snapshot() DiagnosticsSnapshot

+ func (d *PageDiagnostics) Stop() (DiagnosticsSnapshot, error)

+ type PageError struct

+ ExceptionID int

+ Text string

+ type ResourceFailure struct

+ BlockedReason proto.NetworkBlockedReason

+ Canceled bool

+ ErrorText string

+ RequestID proto.NetworkRequestID

+ Status int

+ Type proto.NetworkResourceType

+ URL string

v0.119.0

Sep 6, 2026

v0.118.0

Sep 5, 2026

Changes in this version

+ type EventHandler struct

+ func On[E proto.Event](callback func(*E, proto.TargetSessionID) bool) EventHandler

v0.117.0

Sep 5, 2026

Changes in this version

+ var DefaultLogger = log.New(os.Stdout, "[rod] ", log.LstdFlags)

+ var DefaultSleeper = func() utils.Sleeper

+ func NotFoundSleeper() utils.Sleeper

+ func Try(fn func()) (err error)

+ type Browser struct

+ BrowserContextID proto.BrowserBrowserContextID

+ func New() *Browser

+ func (b *Browser) Call(ctx context.Context, sessionID, methodName string, params interface{}) (res []byte, err error)

+ func (b *Browser) CancelTimeout() *Browser

+ func (b *Browser) Client(c CDPClient) *Browser

+ func (b *Browser) Close() error

+ func (b *Browser) Connect() error

+ func (b *Browser) Context(ctx context.Context) *Browser

+ func (b *Browser) ControlURL(url string) *Browser

+ func (b *Browser) DefaultDevice(d devices.Device) *Browser

+ func (b *Browser) DisableDomain(sessionID proto.TargetSessionID, req proto.Request) (restore func())

+ func (b *Browser) EachEvent(callbacks ...interface{}) (wait func())

+ func (b *Browser) EnableDomain(sessionID proto.TargetSessionID, req proto.Request) (restore func())

+ func (b *Browser) Event() <-chan *Message

+ func (b *Browser) GetContext() context.Context

+ func (b *Browser) GetCookies() ([]*proto.NetworkCookie, error)

+ func (b *Browser) HandleAuth(username, password string) func() error

+ func (b *Browser) HijackRequests() *HijackRouter

+ func (b *Browser) IgnoreCertErrors(enable bool) error

+ func (b *Browser) Incognito() (*Browser, error)

+ func (b *Browser) LoadState(sessionID proto.TargetSessionID, method proto.Request) (has bool)

+ func (b *Browser) Logger(l utils.Logger) *Browser

+ func (b *Browser) Monitor(url string) *Browser

+ func (b *Browser) MustClose()

+ func (b *Browser) MustConnect() *Browser

+ func (b *Browser) MustGetCookies() []*proto.NetworkCookie

+ func (b *Browser) MustHandleAuth(username, password string) (wait func())

+ func (b *Browser) MustIgnoreCertErrors(enable bool) *Browser

+ func (b *Browser) MustIncognito() *Browser

+ func (b *Browser) MustPage(url ...string) *Page

+ func (b *Browser) MustPageFromTargetID(targetID proto.TargetTargetID) *Page

+ func (b *Browser) MustPages() Pages

+ func (b *Browser) MustSetCookies(cookies ...*proto.NetworkCookie) *Browser

+ func (b *Browser) MustVersion() *proto.BrowserGetVersionResult

+ func (b *Browser) MustWaitDownload() func() []byte

+ func (b *Browser) NoDefaultDevice() *Browser

+ func (b *Browser) Page(opts proto.TargetCreateTarget) (p *Page, err error)

+ func (b *Browser) PageFromSession(sessionID proto.TargetSessionID) *Page

+ func (b *Browser) PageFromTarget(targetID proto.TargetTargetID) (*Page, error)

+ func (b *Browser) Pages() (Pages, error)

+ func (b *Browser) RemoveState(key interface{})

+ func (b *Browser) ServeMonitor(host string) string

+ func (b *Browser) SetCookies(cookies []*proto.NetworkCookieParam) error

+ func (b *Browser) Sleeper(sleeper func() utils.Sleeper) *Browser

+ func (b *Browser) SlowMotion(delay time.Duration) *Browser

+ func (b *Browser) Timeout(d time.Duration) *Browser

+ func (b *Browser) Trace(enable bool) *Browser

+ func (b *Browser) Version() (*proto.BrowserGetVersionResult, error)

+ func (b *Browser) WaitDownload(dir string) func() (info *proto.PageDownloadWillBegin)

+ func (b *Browser) WaitEvent(e proto.Event) (wait func())

+ func (b *Browser) WithCancel() (*Browser, func())

+ func (b *Browser) WithPanic(fail func(interface{})) *Browser

+ type CDPClient interface

+ Call func(ctx context.Context, sessionID, method string, params interface{}) ([]byte, error)

+ Event func() <-chan *cdp.Event

+ type CoveredError struct

+ func (e *CoveredError) Error() string

+ func (e *CoveredError) Is(err error) bool

+ func (e *CoveredError) Unwrap() error

+ type Element struct

+ Object *proto.RuntimeRemoteObject

+ func (el *Element) Attribute(name string) (*string, error)

+ func (el *Element) BackgroundImage() ([]byte, error)

+ func (el *Element) Blur() error

+ func (el *Element) Call(ctx context.Context, sessionID, methodName string, params interface{}) (res []byte, err error)

+ func (el *Element) CancelTimeout() *Element

+ func (el *Element) CanvasToImage(format string, quality float64) ([]byte, error)

+ func (el *Element) Click(button proto.InputMouseButton, clickCount int) error

+ func (el *Element) ContainsElement(target *Element) (bool, error)

+ func (el *Element) Context(ctx context.Context) *Element

+ func (el *Element) Describe(depth int, pierce bool) (*proto.DOMNode, error)

+ func (el *Element) Disabled() (bool, error)

+ func (el *Element) Element(selector string) (*Element, error)

+ func (el *Element) ElementByJS(opts *EvalOptions) (*Element, error)

+ func (el *Element) ElementR(selector, jsRegex string) (*Element, error)

+ func (el *Element) ElementX(xPath string) (*Element, error)

+ func (el *Element) Elements(selector string) (Elements, error)

+ func (el *Element) ElementsByJS(opts *EvalOptions) (Elements, error)

+ func (el *Element) ElementsX(xpath string) (Elements, error)

+ func (el *Element) Equal(elm *Element) (bool, error)

+ func (el *Element) Eval(js string, params ...interface{}) (*proto.RuntimeRemoteObject, error)

+ func (el *Element) Evaluate(opts *EvalOptions) (*proto.RuntimeRemoteObject, error)

+ func (el *Element) Focus() error

+ func (el *Element) Frame() (*Page, error)

+ func (el *Element) GetContext() context.Context

+ func (el *Element) GetSessionID() proto.TargetSessionID

+ func (el *Element) GetXPath(optimized bool) (string, error)

+ func (el *Element) HTML() (string, error)

+ func (el *Element) Has(selector string) (bool, *Element, error)

+ func (el *Element) HasR(selector, jsRegex string) (bool, *Element, error)

+ func (el *Element) HasX(selector string) (bool, *Element, error)

+ func (el *Element) Hover() error

+ func (el *Element) Input(text string) error

+ func (el *Element) InputColor(color string) error

+ func (el *Element) InputTime(t time.Time) error

+ func (el *Element) Interactable() (pt *proto.Point, err error)

+ func (el *Element) KeyActions() (*KeyActions, error)

+ func (el *Element) Matches(selector string) (bool, error)

+ func (el *Element) MoveMouseOut() error

+ func (el *Element) MustAttribute(name string) *string

+ func (el *Element) MustBackgroundImage() []byte

+ func (el *Element) MustBlur() *Element

+ func (el *Element) MustCanvasToImage() []byte

+ func (el *Element) MustClick() *Element

+ func (el *Element) MustContainsElement(target *Element) bool

+ func (el *Element) MustDescribe() *proto.DOMNode

+ func (el *Element) MustDisabled() bool

+ func (el *Element) MustDoubleClick() *Element

+ func (el *Element) MustElement(selector string) *Element

+ func (el *Element) MustElementByJS(js string, params ...interface{}) *Element

+ func (el *Element) MustElementR(selector, regex string) *Element

+ func (el *Element) MustElementX(xpath string) *Element

+ func (el *Element) MustElements(selector string) Elements

+ func (el *Element) MustElementsByJS(js string, params ...interface{}) Elements

+ func (el *Element) MustElementsX(xpath string) Elements

+ func (el *Element) MustEqual(elm *Element) bool

+ func (el *Element) MustEval(js string, params ...interface{}) jsonvalue.Value

+ func (el *Element) MustFocus() *Element

+ func (el *Element) MustFrame() *Page

+ func (el *Element) MustGetXPath(optimized bool) string

+ func (el *Element) MustHTML() string

+ func (el *Element) MustHas(selector string) bool

+ func (el *Element) MustHasR(selector, regex string) bool

+ func (el *Element) MustHasX(selector string) bool

+ func (el *Element) MustHover() *Element

+ func (el *Element) MustInput(text string) *Element

+ func (el *Element) MustInputColor(color string) *Element

+ func (el *Element) MustInputTime(t time.Time) *Element

+ func (el *Element) MustInteractable() bool

+ func (el *Element) MustKeyActions() *KeyActions

+ func (el *Element) MustMatches(selector string) bool

+ func (el *Element) MustMoveMouseOut() *Element

+ func (el *Element) MustNext() *Element

+ func (el *Element) MustParent() *Element

+ func (el *Element) MustParents(selector string) Elements

+ func (el *Element) MustPrevious() *Element

+ func (el *Element) MustProperty(name string) jsonvalue.Value

+ func (el *Element) MustRelease()

+ func (el *Element) MustRemove()

+ func (el *Element) MustResource() []byte

+ func (el *Element) MustScreenshot(toFile ...string) []byte

+ func (el *Element) MustScrollIntoView() *Element

+ func (el *Element) MustSelect(selectors ...string) *Element

+ func (el *Element) MustSelectAllText() *Element

+ func (el *Element) MustSelectText(regex string) *Element

+ func (el *Element) MustSetFiles(paths ...string) *Element

+ func (el *Element) MustShadowRoot() *Element

+ func (el *Element) MustShape() *proto.DOMGetContentQuadsResult

+ func (el *Element) MustTap() *Element

+ func (el *Element) MustText() string

+ func (el *Element) MustType(keys ...input.Key) *Element

+ func (el *Element) MustVisible() bool

+ func (el *Element) MustWait(js string, params ...interface{}) *Element

+ func (el *Element) MustWaitEnabled() *Element

+ func (el *Element) MustWaitInteractable() *Element

+ func (el *Element) MustWaitInvisible() *Element

+ func (el *Element) MustWaitLoad() *Element

+ func (el *Element) MustWaitStable() *Element

+ func (el *Element) MustWaitVisible() *Element

+ func (el *Element) MustWaitWritable() *Element

+ func (el *Element) Next() (*Element, error)

+ func (el *Element) Overlay(msg string) (removeOverlay func())

+ func (el *Element) Page() *Page

+ func (el *Element) Parent() (*Element, error)

+ func (el *Element) Parents(selector string) (Elements, error)

+ func (el *Element) Previous() (*Element, error)

+ func (el *Element) Property(name string) (jsonvalue.Value, error)

+ func (el *Element) Release() error

+ func (el *Element) Remove() error

+ func (el *Element) Resource() ([]byte, error)

+ func (el *Element) Screenshot(format proto.PageCaptureScreenshotFormat, quality int) ([]byte, error)

+ func (el *Element) ScrollIntoView() error

+ func (el *Element) Select(selectors []string, selected bool, t SelectorType) error

+ func (el *Element) SelectAllText() error

+ func (el *Element) SelectText(regex string) error

+ func (el *Element) SetFiles(paths []string) error

+ func (el *Element) ShadowRoot() (*Element, error)

+ func (el *Element) Shape() (*proto.DOMGetContentQuadsResult, error)

+ func (el *Element) Sleeper(sleeper func() utils.Sleeper) *Element

+ func (el *Element) String() string

+ func (el *Element) Tap() error

+ func (el *Element) Text() (string, error)

+ func (el *Element) Timeout(d time.Duration) *Element

+ func (el *Element) Type(keys ...input.Key) error

+ func (el *Element) Visible() (bool, error)

+ func (el *Element) Wait(opts *EvalOptions) error

+ func (el *Element) WaitEnabled() error

+ func (el *Element) WaitInteractable() (pt *proto.Point, err error)

+ func (el *Element) WaitInvisible() error

+ func (el *Element) WaitLoad() error

+ func (el *Element) WaitStable(d time.Duration) error

+ func (el *Element) WaitStableRAF() error

+ func (el *Element) WaitVisible() error

+ func (el *Element) WaitWritable() error

+ func (el *Element) WithCancel() (*Element, func())

+ func (el *Element) WithPanic(fail func(interface{})) *Element

+ type ElementNotFoundError struct

+ func (e *ElementNotFoundError) Error() string

+ type Elements []*Element

+ func (els Elements) Empty() bool

+ func (els Elements) First() *Element

+ func (els Elements) Last() *Element

+ type EvalError struct

+ func (e *EvalError) Error() string

+ func (e *EvalError) Is(err error) bool

+ type EvalOptions struct

+ AwaitPromise bool

+ ByValue bool

+ JS string

+ JSArgs []interface{}

+ ThisObj *proto.RuntimeRemoteObject

+ UserGesture bool

+ func Eval(js string, args ...interface{}) *EvalOptions

+ func (e *EvalOptions) ByObject() *EvalOptions

+ func (e *EvalOptions) ByPromise() *EvalOptions

+ func (e *EvalOptions) ByUser() *EvalOptions

+ func (e *EvalOptions) String() string

+ func (e *EvalOptions) This(obj *proto.RuntimeRemoteObject) *EvalOptions

+ type ExpectElementError struct

+ func (e *ExpectElementError) Error() string

+ func (e *ExpectElementError) Is(err error) bool

+ type ExpectElementsError struct

+ func (e *ExpectElementsError) Error() string

+ func (e *ExpectElementsError) Is(err error) bool

+ type Hijack struct

+ CustomState interface{}

+ OnError func(error)

+ Request *HijackRequest

+ Response *HijackResponse

+ Skip bool

+ func (h *Hijack) ContinueRequest(cq *proto.FetchContinueRequest)

+ func (h *Hijack) LoadResponse(client *http.Client, loadBody bool) error

+ func (h *Hijack) MustLoadResponse()

+ type HijackRequest struct

+ func (ctx *HijackRequest) Body() string

+ func (ctx *HijackRequest) Header(key string) string

+ func (ctx *HijackRequest) Headers() proto.NetworkHeaders

+ func (ctx *HijackRequest) IsNavigation() bool

+ func (ctx *HijackRequest) JSONBody() jsonvalue.Value

+ func (ctx *HijackRequest) Method() string

+ func (ctx *HijackRequest) Req() *http.Request

+ func (ctx *HijackRequest) SetBody(obj interface{}) *HijackRequest

+ func (ctx *HijackRequest) SetContext(c context.Context) *HijackRequest

+ func (ctx *HijackRequest) Type() proto.NetworkResourceType

+ func (ctx *HijackRequest) URL() *url.URL

+ type HijackResponse struct

+ RawResponse *http.Response

+ func (ctx *HijackResponse) AddHeader(pairs ...string) *HijackResponse

+ func (ctx *HijackResponse) Body() string

+ func (ctx *HijackResponse) Fail(reason proto.NetworkErrorReason) *HijackResponse

+ func (ctx *HijackResponse) Headers() http.Header

+ func (ctx *HijackResponse) Payload() *proto.FetchFulfillRequest

+ func (ctx *HijackResponse) SetBody(obj interface{}) *HijackResponse

+ func (ctx *HijackResponse) SetHeader(pairs ...string) *HijackResponse

+ type HijackRouter struct

+ func (r *HijackRouter) Add(pattern string, resourceType proto.NetworkResourceType, handler func(*Hijack)) error

+ func (r *HijackRouter) MustAdd(pattern string, handler func(*Hijack)) *HijackRouter

+ func (r *HijackRouter) MustRemove(pattern string) *HijackRouter

+ func (r *HijackRouter) MustStop()

+ func (r *HijackRouter) Remove(pattern string) error

+ func (r *HijackRouter) Run()

+ func (r *HijackRouter) Stop() error

+ type InvisibleShapeError struct

+ func (e *InvisibleShapeError) Error() string

+ func (e *InvisibleShapeError) Is(err error) bool

+ func (e *InvisibleShapeError) Unwrap() error

+ type KeyAction struct

+ Key input.Key

+ Type KeyActionType

+ type KeyActionType int

+ const KeyActionPress

+ const KeyActionRelease

+ const KeyActionTypeKey

+ type KeyActions struct

+ Actions []KeyAction

+ func (ka *KeyActions) Do() (err error)

+ func (ka *KeyActions) MustDo()

+ func (ka *KeyActions) Press(keys ...input.Key) *KeyActions

+ func (ka *KeyActions) Release(keys ...input.Key) *KeyActions

+ func (ka *KeyActions) Type(keys ...input.Key) *KeyActions

+ type Keyboard struct

+ func (k *Keyboard) MustType(key ...input.Key) *Keyboard

+ func (k *Keyboard) Press(key input.Key) error

+ func (k *Keyboard) Release(key input.Key) error

+ func (k *Keyboard) Type(keys ...input.Key) (err error)

+ type Message struct

+ Method string

+ SessionID proto.TargetSessionID

+ func (msg *Message) Load(e proto.Event) bool

+ type Mouse struct

+ func (m *Mouse) Click(button proto.InputMouseButton, clickCount int) error

+ func (m *Mouse) Down(button proto.InputMouseButton, clickCount int) error

+ func (m *Mouse) MoveAlong(guide func() (proto.Point, bool)) error

+ func (m *Mouse) MoveLinear(to proto.Point, steps int) error

+ func (m *Mouse) MoveTo(p proto.Point) error

+ func (m *Mouse) MustClick(button proto.InputMouseButton) *Mouse

+ func (m *Mouse) MustDown(button proto.InputMouseButton) *Mouse

+ func (m *Mouse) MustMoveTo(x, y float64) *Mouse

+ func (m *Mouse) MustScroll(x, y float64) *Mouse

+ func (m *Mouse) MustUp(button proto.InputMouseButton) *Mouse

+ func (m *Mouse) Position() proto.Point

+ func (m *Mouse) Scroll(offsetX, offsetY float64, steps int) error

+ func (m *Mouse) Up(button proto.InputMouseButton, clickCount int) error

+ type NavigationError struct

+ Reason string

+ func (e *NavigationError) Error() string

+ func (e *NavigationError) Is(err error) bool

+ type NoPointerEventsError struct

+ func (e *NoPointerEventsError) Error() string

+ func (e *NoPointerEventsError) Is(err error) bool

+ func (e *NoPointerEventsError) Unwrap() error

+ type NoShadowRootError struct

+ func (e *NoShadowRootError) Error() string

+ func (e *NoShadowRootError) Is(err error) bool

+ type NotInteractableError struct

+ func (e *NotInteractableError) Error() string

+ type ObjectNotFoundError struct

+ func (e *ObjectNotFoundError) Error() string

+ func (e *ObjectNotFoundError) Is(err error) bool

+ type Page struct

+ FrameID proto.PageFrameID

+ Keyboard *Keyboard

+ Mouse *Mouse

+ SessionID proto.TargetSessionID

+ TargetID proto.TargetTargetID

+ Touch *Touch

+ func (p *Page) Activate() (*Page, error)

+ func (p *Page) AddScriptTag(url, content string) error

+ func (p *Page) AddStyleTag(url, content string) error

+ func (p *Page) Browser() *Browser

+ func (p *Page) Call(ctx context.Context, sessionID, methodName string, params interface{}) (res []byte, err error)

+ func (p *Page) CancelTimeout() *Page

+ func (p *Page) CaptureDOMSnapshot() (domSnapshot *proto.DOMSnapshotCaptureSnapshotResult, err error)

+ func (p *Page) Close() error

+ func (p *Page) Context(ctx context.Context) *Page

+ func (p *Page) Cookies(urls []string) ([]*proto.NetworkCookie, error)

+ func (p *Page) DisableDomain(method proto.Request) (restore func())

+ func (p *Page) EachEvent(callbacks ...interface{}) (wait func())

+ func (p *Page) Element(selector string) (*Element, error)

+ func (p *Page) ElementByJS(opts *EvalOptions) (*Element, error)

+ func (p *Page) ElementFromNode(node *proto.DOMNode) (*Element, error)

+ func (p *Page) ElementFromObject(obj *proto.RuntimeRemoteObject) (*Element, error)

+ func (p *Page) ElementFromPoint(x, y int) (*Element, error)

+ func (p *Page) ElementR(selector, jsRegex string) (*Element, error)

+ func (p *Page) ElementX(xPath string) (*Element, error)

+ func (p *Page) Elements(selector string) (Elements, error)

+ func (p *Page) ElementsByJS(opts *EvalOptions) (Elements, error)

+ func (p *Page) ElementsX(xpath string) (Elements, error)

+ func (p *Page) Emulate(device devices.Device) error

+ func (p *Page) EnableDomain(method proto.Request) (restore func())

+ func (p *Page) Eval(js string, args ...interface{}) (*proto.RuntimeRemoteObject, error)

+ func (p *Page) EvalOnNewDocument(js string) (remove func() error, err error)

+ func (p *Page) Evaluate(opts *EvalOptions) (res *proto.RuntimeRemoteObject, err error)

+ func (p *Page) Event() <-chan *Message

+ func (p *Page) Expose(name string, fn func(jsonvalue.Value) (interface{}, error)) (stop func() error, err error)

+ func (p *Page) ExposeHelpers(list ...*js.Function)

+ func (p *Page) GetContext() context.Context

+ func (p *Page) GetNavigationHistory() (*proto.PageGetNavigationHistoryResult, error)

+ func (p *Page) GetResource(url string) ([]byte, error)

+ func (p *Page) GetSessionID() proto.TargetSessionID

+ func (p *Page) GetWindow() (*proto.BrowserBounds, error)

+ func (p *Page) HTML() (string, error)

+ func (p *Page) HandleDialog() (wait func() *proto.PageJavascriptDialogOpening, ...)

+ func (p *Page) HandleFileDialog() (func([]string) error, error)

+ func (p *Page) Has(selector string) (bool, *Element, error)

+ func (p *Page) HasR(selector, jsRegex string) (bool, *Element, error)

+ func (p *Page) HasX(selector string) (bool, *Element, error)

+ func (p *Page) HijackRequests() *HijackRouter

+ func (p *Page) Info() (*proto.TargetTargetInfo, error)

+ func (p *Page) InsertText(text string) error

+ func (p *Page) IsIframe() bool

+ func (p *Page) KeyActions() *KeyActions

+ func (p *Page) LoadState(method proto.Request) (has bool)

+ func (p *Page) MustActivate() *Page

+ func (p *Page) MustAddScriptTag(url string) *Page

+ func (p *Page) MustAddStyleTag(url string) *Page

+ func (p *Page) MustCaptureDOMSnapshot() (domSnapshot *proto.DOMSnapshotCaptureSnapshotResult)

+ func (p *Page) MustClose()

+ func (p *Page) MustCookies(urls ...string) []*proto.NetworkCookie

+ func (p *Page) MustElement(selector string) *Element

+ func (p *Page) MustElementByJS(js string, params ...interface{}) *Element

+ func (p *Page) MustElementFromNode(node *proto.DOMNode) *Element

+ func (p *Page) MustElementFromPoint(left, top int) *Element

+ func (p *Page) MustElementR(selector, jsRegex string) *Element

+ func (p *Page) MustElementX(xPath string) *Element

+ func (p *Page) MustElements(selector string) Elements

+ func (p *Page) MustElementsByJS(js string, params ...interface{}) Elements

+ func (p *Page) MustElementsX(xpath string) Elements

+ func (p *Page) MustEmulate(device devices.Device) *Page

+ func (p *Page) MustEval(js string, params ...interface{}) jsonvalue.Value

+ func (p *Page) MustEvalOnNewDocument(js string)

+ func (p *Page) MustEvaluate(opts *EvalOptions) *proto.RuntimeRemoteObject

+ func (p *Page) MustExpose(name string, fn func(jsonvalue.Value) (interface{}, error)) (stop func())

+ func (p *Page) MustGetWindow() *proto.BrowserBounds

+ func (p *Page) MustHTML() string

+ func (p *Page) MustHandleDialog() (wait func() *proto.PageJavascriptDialogOpening, handle func(bool, string))

+ func (p *Page) MustHandleFileDialog() func(...string)

+ func (p *Page) MustHas(selector string) bool

+ func (p *Page) MustHasR(selector, regex string) bool

+ func (p *Page) MustHasX(selector string) bool

+ func (p *Page) MustInfo() *proto.TargetTargetInfo

+ func (p *Page) MustInsertText(text string) *Page

+ func (p *Page) MustNavigate(url string) *Page

+ func (p *Page) MustNavigateBack() *Page

+ func (p *Page) MustNavigateForward() *Page

+ func (p *Page) MustObjectToJSON(obj *proto.RuntimeRemoteObject) jsonvalue.Value

+ func (p *Page) MustObjectsToJSON(list []*proto.RuntimeRemoteObject) jsonvalue.Value

+ func (p *Page) MustPDF(toFile ...string) []byte

+ func (p *Page) MustRelease(obj *proto.RuntimeRemoteObject) *Page

+ func (p *Page) MustReload() *Page

+ func (p *Page) MustResetNavigationHistory() *Page

+ func (p *Page) MustScreenshot(toFile ...string) []byte

+ func (p *Page) MustScreenshotFullPage(toFile ...string) []byte

+ func (p *Page) MustScrollScreenshot(toFile ...string) []byte

+ func (p *Page) MustSearch(query string) *Element

+ func (p *Page) MustSetBlockedURLs(urls ...string) *Page

+ func (p *Page) MustSetCookies(cookies ...*proto.NetworkCookieParam) *Page

+ func (p *Page) MustSetDocumentContent(html string) *Page

+ func (p *Page) MustSetExtraHeaders(dict ...string) (cleanup func())

+ func (p *Page) MustSetUserAgent(req *proto.NetworkSetUserAgentOverride) *Page

+ func (p *Page) MustSetViewport(width, height int, deviceScaleFactor float64, mobile bool) *Page

+ func (p *Page) MustSetWindow(left, top, width, height int) *Page

+ func (p *Page) MustStopLoading() *Page

+ func (p *Page) MustTriggerFavicon() *Page

+ func (p *Page) MustWait(js string, params ...interface{}) *Page

+ func (p *Page) MustWaitDOMStable() *Page

+ func (p *Page) MustWaitElementsMoreThan(selector string, num int) *Page

+ func (p *Page) MustWaitIdle() *Page

+ func (p *Page) MustWaitLoad() *Page

+ func (p *Page) MustWaitNavigation() func()

+ func (p *Page) MustWaitOpen() (wait func() (newPage *Page))

+ func (p *Page) MustWaitRequestIdle(excludes ...string) (wait func())

+ func (p *Page) MustWaitStable() *Page

+ func (p *Page) MustWindowFullscreen() *Page

+ func (p *Page) MustWindowMaximize() *Page

+ func (p *Page) MustWindowMinimize() *Page

+ func (p *Page) MustWindowNormal() *Page

+ func (p *Page) Navigate(url string) error

+ func (p *Page) NavigateBack() error

+ func (p *Page) NavigateForward() error

+ func (p *Page) ObjectToJSON(obj *proto.RuntimeRemoteObject) (jsonvalue.Value, error)

+ func (p *Page) Overlay(left, top, width, height float64, msg string) (remove func())

+ func (p *Page) PDF(req *proto.PagePrintToPDF) (*StreamReader, error)

+ func (p *Page) Race() *RaceContext

+ func (p *Page) Release(obj *proto.RuntimeRemoteObject) error

+ func (p *Page) Reload() error

+ func (p *Page) ResetNavigationHistory() error

+ func (p *Page) Screenshot(fullPage bool, req *proto.PageCaptureScreenshot) ([]byte, error)

+ func (p *Page) ScrollScreenshot(opt *ScrollScreenshotOptions) ([]byte, error)

+ func (p *Page) Search(query string) (*SearchResult, error)

+ func (p *Page) SetBlockedURLs(urls []string) error

+ func (p *Page) SetCookies(cookies []*proto.NetworkCookieParam) error

+ func (p *Page) SetDocumentContent(html string) error

+ func (p *Page) SetExtraHeaders(dict []string) (func(), error)

+ func (p *Page) SetUserAgent(req *proto.NetworkSetUserAgentOverride) error

+ func (p *Page) SetViewport(params *proto.EmulationSetDeviceMetricsOverride) error

+ func (p *Page) SetWindow(bounds *proto.BrowserBounds) error

+ func (p *Page) Sleeper(sleeper func() utils.Sleeper) *Page

+ func (p *Page) StopLoading() error

+ func (p *Page) String() string

+ func (p *Page) Timeout(d time.Duration) *Page

+ func (p *Page) TriggerFavicon() error

+ func (p *Page) Wait(opts *EvalOptions) error

+ func (p *Page) WaitDOMStable(d time.Duration, diff float64) error

+ func (p *Page) WaitElementsMoreThan(selector string, num int) error

+ func (p *Page) WaitEvent(e proto.Event) (wait func())

+ func (p *Page) WaitIdle(timeout time.Duration) (err error)

+ func (p *Page) WaitLoad() error

+ func (p *Page) WaitNavigation(name proto.PageLifecycleEventName) func()

+ func (p *Page) WaitOpen() func() (*Page, error)

+ func (p *Page) WaitRepaint() error

+ func (p *Page) WaitRequestIdle(d time.Duration, includes, excludes []string, ...) func()

+ func (p *Page) WaitStable(d time.Duration) error

+ func (p *Page) WithCancel() (*Page, func())

+ func (p *Page) WithPanic(fail func(interface{})) *Page

+ type PageCloseCanceledError struct

+ func (e *PageCloseCanceledError) Error() string

+ type PageNotFoundError struct

+ func (e *PageNotFoundError) Error() string

+ type Pages []*Page

+ func (ps Pages) Empty() bool

+ func (ps Pages) Find(selector string) (*Page, error)

+ func (ps Pages) FindByURL(jsRegex string) (*Page, error)

+ func (ps Pages) First() *Page

+ func (ps Pages) Last() *Page

+ func (ps Pages) MustFind(selector string) *Page

+ func (ps Pages) MustFindByURL(regex string) *Page

+ type Pool chan *T

+ func NewBrowserPool(limit int) Pool[Browser]

+ func NewPagePool(limit int) Pool[Page]

+ func NewPool[T any](limit int) Pool[T]

+ func (p Pool[T]) Cleanup(iteratee func(*T))

+ func (p Pool[T]) Get(create func() (*T, error)) (elem *T, err error)

+ func (p Pool[T]) MustGet(create func() *T) *T

+ func (p Pool[T]) Put(elem *T)

+ type RaceContext struct

+ func (rc *RaceContext) Do() (*Element, error)

+ func (rc *RaceContext) Element(selector string) *RaceContext

+ func (rc *RaceContext) ElementByJS(opts *EvalOptions) *RaceContext

+ func (rc *RaceContext) ElementFunc(fn func(*Page) (*Element, error)) *RaceContext

+ func (rc *RaceContext) ElementR(selector, regex string) *RaceContext

+ func (rc *RaceContext) ElementX(selector string) *RaceContext

+ func (rc *RaceContext) Handle(callback func(*Element) error) *RaceContext

+ func (rc *RaceContext) MustDo() *Element

+ func (rc *RaceContext) MustElementByJS(js string, params []interface{}) *RaceContext

+ func (rc *RaceContext) MustHandle(callback func(*Element)) *RaceContext

+ func (rc *RaceContext) Search(query string) *RaceContext

+ type ScrollScreenshotOptions struct

+ FixedBottom float64

+ FixedTop float64

+ Format proto.PageCaptureScreenshotFormat

+ Quality *int

+ WaitPerScroll time.Duration

+ type SearchResult struct

+ First *Element

+ func (s *SearchResult) All() (Elements, error)

+ func (s *SearchResult) Get(i, l int) (Elements, error)

+ func (s *SearchResult) Release()

+ type SelectorType string

+ const SelectorTypeCSSSector

+ const SelectorTypeRegex

+ const SelectorTypeText

+ type StreamReader struct

+ Offset *int

+ func NewStreamReader(c proto.Client, h proto.IOStreamHandle) *StreamReader

+ func (sr *StreamReader) Close() error

+ func (sr *StreamReader) Read(p []byte) (n int, err error)

+ type Touch struct

+ func (t *Touch) Cancel() error

+ func (t *Touch) End() error

+ func (t *Touch) Move(points ...*proto.InputTouchPoint) error

+ func (t *Touch) MustCancel() *Touch

+ func (t *Touch) MustEnd() *Touch

+ func (t *Touch) MustMove(points ...*proto.InputTouchPoint) *Touch

+ func (t *Touch) MustStart(points ...*proto.InputTouchPoint) *Touch

+ func (t *Touch) MustTap(x, y float64) *Touch

+ func (t *Touch) Start(points ...*proto.InputTouchPoint) error

+ func (t *Touch) Tap(x, y float64) error

+ type TraceType string

+ const TraceTypeInput

+ const TraceTypeQuery

+ const TraceTypeWait

+ const TraceTypeWaitRequests

+ const TraceTypeWaitRequestsIdle

+ func (t TraceType) String() string

+ type TryError struct

+ Stack string

+ Value interface{}

+ func (e *TryError) Error() string

+ func (e *TryError) Is(err error) bool

+ func (e *TryError) Unwrap() error

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