drivers

package
v0.8.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 23, 2019 License: Apache-2.0 Imports: 16 Imported by: 41

Documentation

Index

Constants

View Source 
const (
	// Event indicating to wait for value to appear
	WaitEventPresence = 0

	// Event indicating to wait for value to disappear
	WaitEventAbsence = 1
)
View Source 
const DefaultTimeout = time.Second * 30

Variables

View Source 
var (
	ErrDetached = errors.New("element detached")
	ErrNotFound = errors.New("element(s) not found")
)
View Source 
var (
	HTTPHeaderType   = core.NewType("HTTPHeader")
	HTTPCookieType   = core.NewType("HTTPCookie")
	HTMLElementType  = core.NewType("HTMLElement")
	HTMLDocumentType = core.NewType("HTMLDocument")
	HTMLPageType     = core.NewType("HTMLPageType")
)

Functions

func Compare added in v0.7.0 

func Compare(first, second core.Type) int64

func IsScreenshotFormatValid added in v0.7.0 

func IsScreenshotFormatValid(format string) bool

func WithContext added in v0.7.0 

func WithContext(ctx context.Context, drv Driver, opts ...Option) context.Context

func WithDefaultTimeout added in v0.7.0 

func WithDefaultTimeout(ctx context.Context) (context.Context, context.CancelFunc)

Types

type Driver added in v0.7.0 

type Driver interface {
	io.Closer
	Name() string
	Open(ctx context.Context, params Params) (HTMLPage, error)
}

func FromContext added in v0.7.0 

func FromContext(ctx context.Context, name string) (Driver, error)

type HTMLDocument added in v0.7.0 

type HTMLDocument interface {
	HTMLNode

	GetTitle() values.String

	GetElement() HTMLElement

	GetURL() values.String

	GetName() values.String

	GetParentDocument() HTMLDocument

	GetChildDocuments(ctx context.Context) (*values.Array, error)

	ClickBySelector(ctx context.Context, selector values.String) (values.Boolean, error)

	ClickBySelectorAll(ctx context.Context, selector values.String) (values.Boolean, error)

	InputBySelector(ctx context.Context, selector values.String, value core.Value, delay values.Int) (values.Boolean, error)

	SelectBySelector(ctx context.Context, selector values.String, value *values.Array) (*values.Array, error)

	ScrollTop(ctx context.Context) error

	ScrollBottom(ctx context.Context) error

	ScrollBySelector(ctx context.Context, selector values.String) error

	ScrollByXY(ctx context.Context, x, y values.Float) error

	FocusBySelector(ctx context.Context, selector values.String) error

	MoveMouseByXY(ctx context.Context, x, y values.Float) error

	MoveMouseBySelector(ctx context.Context, selector values.String) error

	WaitForElement(ctx context.Context, selector values.String, when WaitEvent) error

	WaitForAttributeBySelector(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error

	WaitForAttributeBySelectorAll(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error

	WaitForStyleBySelector(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error

	WaitForStyleBySelectorAll(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error

	WaitForClassBySelector(ctx context.Context, selector, class values.String, when WaitEvent) error

	WaitForClassBySelectorAll(ctx context.Context, selector, class values.String, when WaitEvent) error
}

func ToDocument added in v0.8.0 

func ToDocument(value core.Value) (HTMLDocument, error)

type HTMLElement added in v0.7.0 

type HTMLElement interface {
	HTMLNode

	GetInnerText(ctx context.Context) (values.String, error)

	SetInnerText(ctx context.Context, innerText values.String) error

	GetInnerHTML(ctx context.Context) (values.String, error)

	SetInnerHTML(ctx context.Context, innerHTML values.String) error

	GetValue(ctx context.Context) core.Value

	SetValue(ctx context.Context, value core.Value) error

	GetStyles(ctx context.Context) (*values.Object, error)

	GetStyle(ctx context.Context, name values.String) (core.Value, error)

	SetStyles(ctx context.Context, values *values.Object) error

	SetStyle(ctx context.Context, name values.String, value core.Value) error

	RemoveStyle(ctx context.Context, name ...values.String) error

	GetAttributes(ctx context.Context) *values.Object

	GetAttribute(ctx context.Context, name values.String) core.Value

	SetAttributes(ctx context.Context, values *values.Object) error

	SetAttribute(ctx context.Context, name, value values.String) error

	RemoveAttribute(ctx context.Context, name ...values.String) error

	GetInnerHTMLBySelector(ctx context.Context, selector values.String) (values.String, error)

	SetInnerHTMLBySelector(ctx context.Context, selector, innerHTML values.String) error

	GetInnerHTMLBySelectorAll(ctx context.Context, selector values.String) (*values.Array, error)

	GetInnerTextBySelector(ctx context.Context, selector values.String) (values.String, error)

	SetInnerTextBySelector(ctx context.Context, selector, innerText values.String) error

	GetInnerTextBySelectorAll(ctx context.Context, selector values.String) (*values.Array, error)

	Click(ctx context.Context) (values.Boolean, error)

	Input(ctx context.Context, value core.Value, delay values.Int) error

	Select(ctx context.Context, value *values.Array) (*values.Array, error)

	ScrollIntoView(ctx context.Context) error

	Focus(ctx context.Context) error

	Hover(ctx context.Context) error

	WaitForAttribute(ctx context.Context, name values.String, value core.Value, when WaitEvent) error

	WaitForStyle(ctx context.Context, name values.String, value core.Value, when WaitEvent) error

	WaitForClass(ctx context.Context, class values.String, when WaitEvent) error
}

HTMLElement is the most general base interface which most objects in a GetMainFrame implement.

func ToElement added in v0.8.0 

func ToElement(value core.Value) (HTMLElement, error)

type HTMLNode added in v0.7.0 

type HTMLNode interface {
	core.Value
	core.Iterable
	core.Getter
	core.Setter
	collections.Measurable
	io.Closer

	IsDetached() values.Boolean

	GetNodeType() values.Int

	GetNodeName() values.String

	GetChildNodes(ctx context.Context) core.Value

	GetChildNode(ctx context.Context, idx values.Int) core.Value

	QuerySelector(ctx context.Context, selector values.String) core.Value

	QuerySelectorAll(ctx context.Context, selector values.String) core.Value

	CountBySelector(ctx context.Context, selector values.String) values.Int

	ExistsBySelector(ctx context.Context, selector values.String) values.Boolean

	XPath(ctx context.Context, expression values.String) (core.Value, error)
}

Node is an interface from which a number of DOM API object types inherit. It allows those types to be treated similarly; for example, inheriting the same set of methods, or being tested in the same way.

type HTMLPage added in v0.8.0 

type HTMLPage interface {
	core.Value
	core.Iterable
	core.Getter
	core.Setter
	collections.Measurable
	io.Closer

	IsClosed() values.Boolean

	GetURL() values.String

	GetMainFrame() HTMLDocument

	GetFrames(ctx context.Context) (*values.Array, error)

	GetFrame(ctx context.Context, idx values.Int) (core.Value, error)

	GetCookies(ctx context.Context) (*values.Array, error)

	SetCookies(ctx context.Context, cookies ...HTTPCookie) error

	DeleteCookies(ctx context.Context, cookies ...HTTPCookie) error

	PrintToPDF(ctx context.Context, params PDFParams) (values.Binary, error)

	CaptureScreenshot(ctx context.Context, params ScreenshotParams) (values.Binary, error)

	WaitForNavigation(ctx context.Context) error

	Navigate(ctx context.Context, url values.String) error

	NavigateBack(ctx context.Context, skip values.Int) (values.Boolean, error)

	NavigateForward(ctx context.Context, skip values.Int) (values.Boolean, error)
}

HTMLPage interface represents any web page loaded in the browser and serves as an entry point into the web page's content

func ToPage added in v0.8.0 

func ToPage(value core.Value) (HTMLPage, error)

type HTTPCookie added in v0.7.0 

type HTTPCookie struct {
	Name     string
	Value    string
	Path     string
	Domain   string
	Expires  time.Time
	MaxAge   int
	Secure   bool
	HTTPOnly bool
	SameSite SameSite
}

HTTPCookie HTTPCookie object

func (HTTPCookie) Compare added in v0.7.0 

func (c HTTPCookie) Compare(other core.Value) int64

func (HTTPCookie) Copy added in v0.7.0 

func (c HTTPCookie) Copy() core.Value

func (HTTPCookie) GetIn added in v0.7.0 

func (c HTTPCookie) GetIn(_ context.Context, path []core.Value) (core.Value, error)

func (HTTPCookie) Hash added in v0.7.0 

func (c HTTPCookie) Hash() uint64

func (HTTPCookie) MarshalJSON added in v0.7.0 

func (c HTTPCookie) MarshalJSON() ([]byte, error)

func (HTTPCookie) String added in v0.7.0 

func (c HTTPCookie) String() string

func (HTTPCookie) Type added in v0.7.0 

func (c HTTPCookie) Type() core.Type

func (HTTPCookie) Unwrap added in v0.7.0 

func (c HTTPCookie) Unwrap() interface{}

type HTTPHeader added in v0.7.0 

type HTTPHeader map[string][]string

HTTPHeader HTTP header object

func (HTTPHeader) Compare added in v0.7.0 

func (h HTTPHeader) Compare(other core.Value) int64

func (HTTPHeader) Copy added in v0.7.0 

func (h HTTPHeader) Copy() core.Value

func (HTTPHeader) Get added in v0.7.0 

func (h HTTPHeader) Get(key string) string

func (HTTPHeader) GetIn added in v0.7.0 

func (h HTTPHeader) GetIn(_ context.Context, path []core.Value) (core.Value, error)

func (HTTPHeader) Hash added in v0.7.0 

func (h HTTPHeader) Hash() uint64

func (HTTPHeader) MarshalJSON added in v0.7.0 

func (h HTTPHeader) MarshalJSON() ([]byte, error)

func (HTTPHeader) Set added in v0.7.0 

func (h HTTPHeader) Set(key, value string)

func (HTTPHeader) String added in v0.7.0 

func (h HTTPHeader) String() string

func (HTTPHeader) Type added in v0.7.0 

func (h HTTPHeader) Type() core.Type

func (HTTPHeader) Unwrap added in v0.7.0 

func (h HTTPHeader) Unwrap() interface{}

type Option added in v0.7.0 

type Option func(drv Driver, opts *options)

func AsDefault added in v0.7.0 

func AsDefault() Option

type PDFParams added in v0.7.0 

type PDFParams struct {
	// Paper orientation. Defaults to false.
	Landscape values.Boolean
	// Display values and footer. Defaults to false.
	DisplayHeaderFooter values.Boolean
	// Print background graphics. Defaults to false.
	PrintBackground values.Boolean
	// Scale of the webpage rendering. Defaults to 1.
	Scale values.Float
	// Paper width in inches. Defaults to 8.5 inches.
	PaperWidth values.Float
	// Paper height in inches. Defaults to 11 inches.
	PaperHeight values.Float
	// Top margin in inches. Defaults to 1cm (~0.4 inches).
	MarginTop values.Float
	// Bottom margin in inches. Defaults to 1cm (~0.4 inches).
	MarginBottom values.Float
	// Left margin in inches. Defaults to 1cm (~0.4 inches).
	MarginLeft values.Float
	// Right margin in inches. Defaults to 1cm (~0.4 inches).
	MarginRight values.Float
	// Paper ranges to print, e.g., '1-5, 8, 11-13'. Defaults to the empty string, which means print all pages.
	PageRanges values.String
	// Whether to silently ignore invalid but successfully parsed page ranges, such as '3-2'. Defaults to false.
	IgnoreInvalidPageRanges values.Boolean
	// HTML template for the print values. Should be valid HTML markup with following classes used to inject printing values into them: - `date`: formatted print date - `title`: document title - `url`: document location - `pageNumber`: current page number - `totalPages`: total pages in the document
	// For example, `<span class=title></span>` would generate span containing the title.
	HeaderTemplate values.String
	// HTML template for the print footer. Should use the same format as the `headerTemplate`.
	FooterTemplate values.String
	// Whether or not to prefer page size as defined by css.
	// Defaults to false, in which case the content will be scaled to fit the paper size.
	PreferCSSPageSize values.Boolean
}

PDFParams represents the arguments for PrintToPDF function.

func NewDefaultHTMLPDFParams added in v0.7.0 

func NewDefaultHTMLPDFParams() PDFParams

type Params added in v0.8.0 

type Params struct {
	URL         string
	UserAgent   string
	KeepCookies bool
	Cookies     []HTTPCookie
	Header      HTTPHeader
	Viewport    *Viewport
}

type SameSite added in v0.7.0 

type SameSite int

Polyfill for Go 1.10 

const (
	SameSiteDefaultMode SameSite = iota + 1
	SameSiteLaxMode
	SameSiteStrictMode
)

func (SameSite) String added in v0.8.0 

func (s SameSite) String() string

type ScreenshotFormat added in v0.7.0 

type ScreenshotFormat string
const (
	ScreenshotFormatPNG  ScreenshotFormat = "png"
	ScreenshotFormatJPEG ScreenshotFormat = "jpeg"
)

type ScreenshotParams added in v0.7.0 

type ScreenshotParams struct {
	X       values.Float
	Y       values.Float
	Width   values.Float
	Height  values.Float
	Format  ScreenshotFormat
	Quality values.Int
}

type Viewport added in v0.8.0 

type Viewport struct {
	Height      int
	Width       int
	ScaleFactor float64
	Mobile      bool
	Landscape   bool
}

type WaitEvent added in v0.7.0 

type WaitEvent int

WaitEvent is an enum that represents what event is needed to wait for

Source Files

View all Source files

Directories

Path Synopsis
cdp
eval
events
input
templates

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.