chromedp

package module
v0.1.4-0...-075927d Latest Latest
Warning

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

 Go to latest Published: Apr 15, 2019 License: MIT Imports: 35 Imported by: 0

README

chromedp v0.2 experimental

chromedp + cdproto v0.2 fork used for LiCoBot

Documentation

Overview

Package chromedp is a high level Chrome DevTools Protocol client that simplifies driving browsers for scraping, unit testing, or profiling web pages using the CDP.

chromedp requires no third-party dependencies, implementing the async Chrome DevTools Protocol entirely in Go.

Index

Examples

Constants

This section is empty.

Variables

View Source 
var (
	// DefaultReadBufferSize is the default maximum read buffer size.
	DefaultReadBufferSize = 25 * 1024 * 1024

	// DefaultWriteBufferSize is the default maximum write buffer size.
	DefaultWriteBufferSize = 10 * 1024 * 1024
)

Functions

func ButtonLeft 

func ButtonLeft(p *input.DispatchMouseEventParams) *input.DispatchMouseEventParams

ButtonLeft is a mouse action option to set the button clicked as the left mouse button.

func ButtonMiddle 

func ButtonMiddle(p *input.DispatchMouseEventParams) *input.DispatchMouseEventParams

ButtonMiddle is a mouse action option to set the button clicked as the middle mouse button.

func ButtonNone 

func ButtonNone(p *input.DispatchMouseEventParams) *input.DispatchMouseEventParams

ButtonNone is a mouse action option to set the button clicked as none (used for mouse movements).

func ButtonRight 

func ButtonRight(p *input.DispatchMouseEventParams) *input.DispatchMouseEventParams

ButtonRight is a mouse action option to set the button clicked as the right mouse button.

func ByID 

func ByID(s *Selector)

ByID is a query option to select a single element by their CSS #id.

func ByNodeID 

func ByNodeID(s *Selector)

ByNodeID is a query option to select elements by their NodeIDs.

func ByQuery 

func ByQuery(s *Selector)

ByQuery is a query option to select a single element using DOM.querySelector.

func ByQueryAll 

func ByQueryAll(s *Selector)

ByQueryAll is a query option to select elements by DOM.querySelectorAll.

func BySearch 

func BySearch(s *Selector)

BySearch is a query option via DOM.performSearch (works with both CSS and XPath queries).

func Cancel 

func Cancel(ctx context.Context) error

Cancel cancels a chromedp context, waits for its resources to be cleaned up, and returns any error encountered during that process.

Usually a "defer cancel()" will be enough for most use cases. This API is useful if you want to catch underlying cancel errors, such as when a temporary directory cannot be deleted.

func DisableGPU 

func DisableGPU(p *ExecAllocator)

DisableGPU is the command line option to disable the GPU process.

func EvalAsValue 

func EvalAsValue(p *runtime.EvaluateParams) *runtime.EvaluateParams

EvalAsValue is a evaluate option that will cause the evaluated script to encode the result of the expression as a JSON-encoded value.

func EvalIgnoreExceptions 

func EvalIgnoreExceptions(p *runtime.EvaluateParams) *runtime.EvaluateParams

EvalIgnoreExceptions is a evaluate option that will cause script evaluation to ignore exceptions.

func EvalWithCommandLineAPI 

func EvalWithCommandLineAPI(p *runtime.EvaluateParams) *runtime.EvaluateParams

EvalWithCommandLineAPI is an evaluate option to make the DevTools Command Line API available to the evaluated script.

Note: this should not be used with untrusted Javascript.

func ForceIP 

func ForceIP(urlstr string) string

ForceIP forces the host component in urlstr to be an IP address.

Since Chrome 66+, Chrome DevTools Protocol clients connecting to a browser must send the "Host:" header as either an IP address, or "localhost".

func Headless 

func Headless(p *ExecAllocator)

Headless is the command line option to run in headless mode.

func NewContext 

func NewContext(parent context.Context, opts ...ContextOption) (context.Context, context.CancelFunc)

NewContext creates a browser context using the parent context.

Example (ManyTabs) 
// new browser, first tab
ctx1, cancel := chromedp.NewContext(context.Background())
defer cancel()

// ensure the first tab is created
if err := chromedp.Run(ctx1); err != nil {
	panic(err)
}

// same browser, second tab
ctx2, _ := chromedp.NewContext(ctx1)

// ensure the second tab is created
if err := chromedp.Run(ctx2); err != nil {
	panic(err)
}

c1 := chromedp.FromContext(ctx1)
c2 := chromedp.FromContext(ctx2)

fmt.Printf("Same browser: %t\n", c1.Browser == c2.Browser)
fmt.Printf("Same tab: %t\n", c1.Target == c2.Target)

Output:

Same browser: true
Same tab: false

func NewExecAllocator 

func NewExecAllocator(parent context.Context, opts ...ExecAllocatorOption) (context.Context, context.CancelFunc)

NewExecAllocator creates a new context set up with an ExecAllocator, suitable for use with NewContext or Run.

func NoDefaultBrowserCheck 

func NoDefaultBrowserCheck(p *ExecAllocator)

NoDefaultBrowserCheck is the Chrome comamnd line option to disable the default browser check.

func NoFirstRun 

func NoFirstRun(p *ExecAllocator)

NoFirstRun is the Chrome comamnd line option to disable the first run dialog.

func NoSandbox 

func NoSandbox(p *ExecAllocator)

NoSandbox is the Chrome comamnd line option to disable the sandbox.

func NodeEnabled 

func NodeEnabled(s *Selector)

NodeEnabled is a query option to wait until the element is enabled.

func NodeNotPresent 

func NodeNotPresent(s *Selector)

NodeNotPresent is a query option to wait until no elements are present matching the selector.

func NodeNotVisible 

func NodeNotVisible(s *Selector)

NodeNotVisible is a query option to wait until the element is not visible.

func NodeReady 

func NodeReady(s *Selector)

NodeReady is a query option to wait until the element is ready.

func NodeSelected 

func NodeSelected(s *Selector)

NodeSelected is a query option to wait until the element is selected.

func NodeVisible 

func NodeVisible(s *Selector)

NodeVisible is a query option to wait until the element is visible.

func Run 

func Run(ctx context.Context, actions ...Action) error

Run runs an action against the provided context. The provided context must contain a valid Allocator; typically, that will be created via NewContext, or via one of the allocator constructors like NewExecAllocator.

func Targets 

func Targets(ctx context.Context) ([]*target.Info, error)

Targets lists all the targets in the browser attached to the given context.

Types

type Action 

type Action interface {
	// Do executes the action using the provided context and frame handler.
	Do(context.Context, cdp.Executor) error
}

Action is the common interface for an action that will be executed against a context and frame handler.

func AttributeValue 

func AttributeValue(sel interface{}, name string, value *string, ok *bool, opts ...QueryOption) Action

AttributeValue retrieves the element attribute value for the first node matching the selector.

func Attributes 

func Attributes(sel interface{}, attributes *map[string]string, opts ...QueryOption) Action

Attributes retrieves the element attributes for the first node matching the selector.

func AttributesAll 

func AttributesAll(sel interface{}, attributes *[]map[string]string, opts ...QueryOption) Action

AttributesAll retrieves the element attributes for all nodes matching the selector.

Note: this should be used with the ByQueryAll selector option.

func Blur 

func Blur(sel interface{}, opts ...QueryOption) Action

Blur unfocuses (blurs) the first node matching the selector.

func CaptureScreenshot 

func CaptureScreenshot(res *[]byte) Action

CaptureScreenshot captures takes a screenshot of the current viewport.

Note: this an alias for page.CaptureScreenshot.

func Clear 

func Clear(sel interface{}, opts ...QueryOption) Action

Clear clears the values of any input/textarea nodes matching the selector.

func Click 

func Click(sel interface{}, opts ...QueryOption) Action

Click sends a mouse click event to the first node matching the selector.

func ClickWait 

func ClickWait(sel interface{}, wait time.Duration, opts ...QueryOption) Action

ClickWait is Click with the button pressed for a duration of wait.

func ComputedStyle 

func ComputedStyle(sel interface{}, style *[]*css.ComputedProperty, opts ...QueryOption) Action

ComputedStyle retrieves the computed style of the first node matching the selector.

func Dimensions 

func Dimensions(sel interface{}, model **dom.BoxModel, opts ...QueryOption) Action

Dimensions retrieves the box model dimensions for the first node matching the selector.

func DoubleClick 

func DoubleClick(sel interface{}, opts ...QueryOption) Action

DoubleClick sends a mouse double click event to the first node matching the selector.

func Evaluate 

func Evaluate(expression string, res interface{}, opts ...EvaluateOption) Action

Evaluate is an action to evaluate the Javascript expression, unmarshaling the result of the script evaluation to res.

When res is a type other than *[]byte, or **chromedp/cdproto/runtime.RemoteObject, then the result of the script evaluation will be returned "by value" (ie, JSON-encoded), and subsequently an attempt will be made to json.Unmarshal the script result to res.

Otherwise, when res is a *[]byte, the raw JSON-encoded value of the script result will be placed in res. Similarly, if res is a *runtime.RemoteObject, then res will be set to the low-level protocol type, and no attempt will be made to convert the result.

Note: any exception encountered will be returned as an error.

func EvaluateAsDevTools 

func EvaluateAsDevTools(expression string, res interface{}, opts ...EvaluateOption) Action

EvaluateAsDevTools is an action that evaluates a Javascript expression as Chrome DevTools would, evaluating the expression in the "console" context, and making the Command Line API available to the script.

Note: this should not be used with untrusted Javascript.

func Focus 

func Focus(sel interface{}, opts ...QueryOption) Action

Focus focuses the first node matching the selector.

func InnerHTML 

func InnerHTML(sel interface{}, html *string, opts ...QueryOption) Action

InnerHTML retrieves the inner html of the first node matching the selector.

func JavascriptAttribute 

func JavascriptAttribute(sel interface{}, name string, res interface{}, opts ...QueryOption) Action

JavascriptAttribute retrieves the Javascript attribute for the first node matching the selector.

func KeyAction 

func KeyAction(keys string, opts ...KeyOption) Action

KeyAction will synthesize a keyDown, char, and keyUp event for each rune contained in keys along with any supplied key options.

Only well-known, "printable" characters will have char events synthesized.

Please see the chromedp/kb package for implementation details and the list of well-known keys.

func KeyActionNode 

func KeyActionNode(n *cdp.Node, keys string, opts ...KeyOption) Action

KeyActionNode dispatches a key event on a node.

func Location 

func Location(urlstr *string) Action

Location retrieves the document location.

func MatchedStyle 

func MatchedStyle(sel interface{}, style **css.GetMatchedStylesForNodeReturns, opts ...QueryOption) Action

MatchedStyle retrieves the matched style information for the first node matching the selector.

func MouseAction 

func MouseAction(typ input.MouseType, x, y int64, opts ...MouseOption) Action

MouseAction is a mouse action.

func MouseClickNode 

func MouseClickNode(n *cdp.Node, wait time.Duration, opts ...MouseOption) Action

MouseClickNode dispatches a mouse left button click event at the center of a specified node.

Note that the window will be scrolled if the node is not within the window's viewport.

func MouseClickXY 

func MouseClickXY(x, y int64, opts ...MouseOption) Action

MouseClickXY sends a left mouse button click (ie, mousePressed and mouseReleased event) at the X, Y location.

func MouseClickXYWait 

func MouseClickXYWait(x, y int64, wait time.Duration, opts ...MouseOption) Action
func Navigate(urlstr string) Action

Navigate navigates the current frame. 

func NavigateBack() Action

NavigateBack navigates the current frame backwards in its history. 

func NavigateForward() Action

NavigateForward navigates the current frame forwards in its history. 

func NavigateToHistoryEntry(entryID int64) Action

NavigateToHistoryEntry is an action to navigate to the specified navigation entry. 

func NavigationEntries(currentIndex *int64, entries *[]*page.NavigationEntry) Action

NavigationEntries is an action to retrieve the page's navigation history entries.

func NodeIDs 

func NodeIDs(sel interface{}, ids *[]cdp.NodeID, opts ...QueryOption) Action

NodeIDs retrieves the node IDs matching the selector.

func Nodes 

func Nodes(sel interface{}, nodes *[]*cdp.Node, opts ...QueryOption) Action

Nodes retrieves the document nodes matching the selector.

func OuterHTML 

func OuterHTML(sel interface{}, html *string, opts ...QueryOption) Action

OuterHTML retrieves the outer html of the first node matching the selector.

func Query 

func Query(sel interface{}, opts ...QueryOption) Action

Query is an action to query for document nodes match the specified sel and the supplied query options.

func QueryAfter 

func QueryAfter(sel interface{}, f func(context.Context, *Target, ...*cdp.Node) error, opts ...QueryOption) Action

QueryAfter is an action that will match the specified sel using the supplied query options, and after the visibility conditions of the query have been met, will execute f.

func Reload 

func Reload() Action

Reload reloads the current page.

func RemoveAttribute 

func RemoveAttribute(sel interface{}, name string, opts ...QueryOption) Action

RemoveAttribute removes the element attribute with name from the first node matching the selector.

func Reset 

func Reset(sel interface{}, opts ...QueryOption) Action

Reset is an action that resets the form of the first node matching the selector belongs to.

func Screenshot 

func Screenshot(sel interface{}, picbuf *[]byte, opts ...QueryOption) Action

Screenshot takes a screenshot of the first node matching the selector.

func ScrollIntoView 

func ScrollIntoView(sel interface{}, opts ...QueryOption) Action

ScrollIntoView scrolls the window to the first node matching the selector.

func SendKeys 

func SendKeys(sel interface{}, v string, opts ...QueryOption) Action

SendKeys synthesizes the key up, char, and down events as needed for the runes in v, sending them to the first node matching the selector.

Note: when selector matches a input[type="file"] node, then dom.SetFileInputFiles is used to set the upload path of the input node to v.

func SetAttributeValue 

func SetAttributeValue(sel interface{}, name, value string, opts ...QueryOption) Action

SetAttributeValue sets the element attribute with name to value for the first node matching the selector.

func SetAttributes 

func SetAttributes(sel interface{}, attributes map[string]string, opts ...QueryOption) Action

SetAttributes sets the element attributes for the first node matching the selector.

func SetJavascriptAttribute 

func SetJavascriptAttribute(sel interface{}, name, value string, opts ...QueryOption) Action

SetJavascriptAttribute sets the javascript attribute for the first node matching the selector.

func SetUploadFiles 

func SetUploadFiles(sel interface{}, files []string, opts ...QueryOption) Action

SetUploadFiles sets the files to upload (ie, for a input[type="file"] node) for the first node matching the selector.

func SetValue 

func SetValue(sel interface{}, value string, opts ...QueryOption) Action

SetValue sets the value of an element.

func Sleep 

func Sleep(d time.Duration) Action

Sleep is an empty action that calls time.Sleep with the specified duration.

Note: this is a temporary action definition for convenience, and will likely be marked for deprecation in the future, after the remaining Actions have been able to be written/tested.

func Stop 

func Stop() Action

Stop stops all navigation and pending resource retrieval.

func Submit 

func Submit(sel interface{}, opts ...QueryOption) Action

Submit is an action that submits the form of the first node matching the selector belongs to.

func Text 

func Text(sel interface{}, text *string, opts ...QueryOption) Action

Text retrieves the visible text of the first node matching the selector.

func Title 

func Title(title *string) Action

Title retrieves the document title.

Example 
ctx, cancel := chromedp.NewContext(context.Background())
defer cancel()

var title string
if err := chromedp.Run(ctx,
	chromedp.Navigate("https://github.com/chromedp/chromedp/issues"),
	chromedp.WaitVisible("#start-of-content", chromedp.ByID),
	chromedp.Title(&title),
); err != nil {
	panic(err)
}

fmt.Println(title)

// no expected output, to not run this test as part of 'go test'; it's
// too slow, requiring internet access.

Output:

func TouchNode 

func TouchNode(n *cdp.Node) Action

func TouchNodeWait 

func TouchNodeWait(n *cdp.Node, wait time.Duration) Action

TODO Merge with MouseClickNodeWait

func TouchXY 

func TouchXY(x, y int64) Action

func TouchXYWait 

func TouchXYWait(x, y int64, wait time.Duration) Action

func Value 

func Value(sel interface{}, value *string, opts ...QueryOption) Action

Value retrieves the value of the first node matching the selector.

func WaitEnabled 

func WaitEnabled(sel interface{}, opts ...QueryOption) Action

WaitEnabled waits until the selected element is enabled (does not have attribute 'disabled').

func WaitNotPresent 

func WaitNotPresent(sel interface{}, opts ...QueryOption) Action

WaitNotPresent waits until no elements match the specified selector.

func WaitNotVisible 

func WaitNotVisible(sel interface{}, opts ...QueryOption) Action

WaitNotVisible waits until the selected element is not visible.

func WaitReady 

func WaitReady(sel interface{}, opts ...QueryOption) Action

WaitReady waits until the element is ready (ie, loaded by chromedp).

func WaitSelected 

func WaitSelected(sel interface{}, opts ...QueryOption) Action

WaitSelected waits until the element is selected (has attribute 'selected').

func WaitVisible 

func WaitVisible(sel interface{}, opts ...QueryOption) Action

WaitVisible waits until the selected element is visible.

type ActionFunc 

type ActionFunc func(context.Context, cdp.Executor) error

ActionFunc is a adapter to allow the use of ordinary func's as an Action.

func (ActionFunc) Do 

func (f ActionFunc) Do(ctx context.Context, h cdp.Executor) error

Do executes the func f using the provided context and frame handler.

type Allocator 

type Allocator interface {
	// Allocate creates a new browser. It can be cancelled via the provided
	// context, at which point all the resources used by the browser (such
	// as temporary directories) will be freed.
	Allocate(context.Context, ...BrowserOption) (*Browser, error)

	// Wait blocks until an allocator has freed all of its resources.
	// Cancelling the context obtained via NewAllocator will already perform
	// this operation, so normally there's no need to call Wait directly.
	Wait()
}

An Allocator is responsible for creating and managing a number of browsers.

This interface abstracts away how the browser process is actually run. For example, an Allocator implementation may reuse browser processes, or connect to already-running browsers on remote machines.

type Browser 

type Browser struct {
	// contains filtered or unexported fields
}

Browser is the high-level Chrome DevTools Protocol browser manager, handling the browser process runner, WebSocket clients, associated targets, and network, page, and DOM events.

func NewBrowser 

func NewBrowser(ctx context.Context, urlstr string, opts ...BrowserOption) (*Browser, error)

NewBrowser creates a new browser.

func (*Browser) Execute 

func (b *Browser) Execute(ctx context.Context, method string, params json.Marshaler, res json.Unmarshaler) error

type BrowserOption 

type BrowserOption func(*Browser)

BrowserOption is a browser option.

func WithBrowserConnLogger 

func WithBrowserConnLogger(log *logrus.Logger, interval time.Duration) BrowserOption

func WithBrowserDebugf 

func WithBrowserDebugf(f func(string, ...interface{})) BrowserOption

WithBrowserDebugf is a browser option to specify a func to log actual websocket messages.

func WithBrowserErrorf 

func WithBrowserErrorf(f func(string, ...interface{})) BrowserOption

WithBrowserErrorf is a browser option to specify a func to receive error logging.

func WithBrowserLogf 

func WithBrowserLogf(f func(string, ...interface{})) BrowserOption

WithBrowserLogf is a browser option to specify a func to receive general logging.

func WithConsolef 

func WithConsolef(f func(string, ...interface{})) BrowserOption

WithConsolef is a browser option to specify a func to receive chrome log events.

Note: NOT YET IMPLEMENTED.

type Conn 

type Conn struct {
	*websocket.Conn
	// contains filtered or unexported fields
}

Conn wraps a gorilla/websocket.Conn connection.

func DialContext 

func DialContext(ctx context.Context, urlstr string, opts ...DialOption) (*Conn, error)

DialContext dials the specified websocket URL using gorilla/websocket.

func (*Conn) Read 

func (c *Conn) Read() (*cdproto.Message, error)

Read reads the next message.

func (*Conn) Watch 

func (c *Conn) Watch(ctx context.Context, logger *logrus.Logger, interval time.Duration)

func (*Conn) Write 

func (c *Conn) Write(msg *cdproto.Message) error

Write writes a message.

type Context 

type Context struct {
	// Allocator is used to create new browsers. It is inherited from the
	// parent context when using NewContext.
	Allocator Allocator

	// Browser is the browser being used in the context. It is inherited
	// from the parent context when using NewContext.
	Browser *Browser

	// Target is the target to run actions (commands) against. It is not
	// inherited from the parent context, and typically each context will
	// have its own unique Target pointing to a separate browser tab (page).
	Target *Target
	// contains filtered or unexported fields
}

Context is attached to any context.Context which is valid for use with Run.

func FromContext 

func FromContext(ctx context.Context) *Context

FromContext extracts the Context data stored inside a context.Context.

type ContextOption 

type ContextOption func(*Context)

ContextOption is a context option.

func WithBrowserOption 

func WithBrowserOption(opts ...BrowserOption) ContextOption

WithBrowserOption allows passing a number of browser options to the allocator when allocating a new browser. As such, this context option can only be used when NewContext is allocating a new browser.

func WithConnLogger 

func WithConnLogger(log *logrus.Logger, interval time.Duration) ContextOption

func WithDebugf 

func WithDebugf(f func(string, ...interface{})) ContextOption

WithDebugf is a shortcut for WithBrowserOption(WithBrowserDebugf(f)).

func WithErrorf 

func WithErrorf(f func(string, ...interface{})) ContextOption

WithErrorf is a shortcut for WithBrowserOption(WithBrowserErrorf(f)).

func WithLogf 

func WithLogf(f func(string, ...interface{})) ContextOption

WithLogf is a shortcut for WithBrowserOption(WithBrowserLogf(f)).

type DialOption 

type DialOption func(*Conn)

DialOption is a dial option.

func WithConnDebugf 

func WithConnDebugf(f func(string, ...interface{})) DialOption

WithConnDebugf is a dial option to set a protocol logger.

type Error 

type Error string

Error is a chromedp error. 

const (
	// ErrInvalidWebsocketMessage is the invalid websocket message.
	ErrInvalidWebsocketMessage Error = "invalid websocket message"

	// ErrInvalidDimensions is the invalid dimensions error.
	ErrInvalidDimensions Error = "invalid dimensions"

	// ErrNoResults is the no results error.
	ErrNoResults Error = "no results"

	// ErrHasResults is the has results error.
	ErrHasResults Error = "has results"

	// ErrNotVisible is the not visible error.
	ErrNotVisible Error = "not visible"

	// ErrVisible is the visible error.
	ErrVisible Error = "visible"

	// ErrDisabled is the disabled error.
	ErrDisabled Error = "disabled"

	// ErrNotSelected is the not selected error.
	ErrNotSelected Error = "not selected"

	// ErrInvalidBoxModel is the invalid box model error.
	ErrInvalidBoxModel Error = "invalid box model"

	// ErrChannelClosed is the channel closed error.
	ErrChannelClosed Error = "channel closed"

	// ErrInvalidHandler is the invalid handler error.
	ErrInvalidHandler Error = "invalid handler"

	// ErrInvalidContext is the invalid context error.
	ErrInvalidContext Error = "invalid context"
)

Error types.

func (Error) Error 

func (err Error) Error() string

Error satisfies the error interface.

type EvaluateOption 

type EvaluateOption func(*runtime.EvaluateParams) *runtime.EvaluateParams

EvaluateOption is the type for script evaluation options.

func EvalObjectGroup 

func EvalObjectGroup(objectGroup string) EvaluateOption

EvalObjectGroup is a evaluate option to set the object group.

type EventFunc 

type EventFunc func(ev interface{})

EventFunc is a type for a function that accepts browser events.

type ExecAllocator 

type ExecAllocator struct {
	// contains filtered or unexported fields
}

ExecAllocator is an Allocator which starts new browser processes on the host machine.

Example 
dir, err := ioutil.TempDir("", "chromedp-example")
if err != nil {
	panic(err)
}
defer os.RemoveAll(dir)

opts := []chromedp.ExecAllocatorOption{
	chromedp.NoFirstRun,
	chromedp.NoDefaultBrowserCheck,
	chromedp.Headless,
	chromedp.DisableGPU,
	chromedp.UserDataDir(dir),
}

allocCtx, cancel := chromedp.NewExecAllocator(context.Background(), opts...)
defer cancel()

taskCtx, cancel := chromedp.NewContext(allocCtx)
defer cancel()

// ensure that the browser process is started
if err := chromedp.Run(taskCtx); err != nil {
	panic(err)
}

path := filepath.Join(dir, "DevToolsActivePort")
bs, err := ioutil.ReadFile(path)
if err != nil {
	panic(err)
}
lines := bytes.Split(bs, []byte("\n"))
fmt.Printf("DevToolsActivePort has %d lines\n", len(lines))

Output:

DevToolsActivePort has 2 lines

func (*ExecAllocator) Allocate 

func (p *ExecAllocator) Allocate(ctx context.Context, opts ...BrowserOption) (*Browser, error)

Allocate satisfies the Allocator interface.

func (*ExecAllocator) Wait 

func (p *ExecAllocator) Wait()

Wait satisfies the Allocator interface.

type ExecAllocatorOption 

type ExecAllocatorOption func(*ExecAllocator)

ExecAllocatorOption is a exec allocator option.

func ExecPath 

func ExecPath(path string) ExecAllocatorOption

ExecPath returns an ExecAllocatorOption which uses the given path to execute browser processes. The given path can be an absolute path to a binary, or just the name of the program to find via exec.LookPath.

func Flag 

func Flag(name string, value interface{}) ExecAllocatorOption

Flag is a generic command line option to pass a flag to Chrome. If the value is a string, it will be passed as --name=value. If it's a boolean, it will be passed as --name if value is true.

func ProxyServer 

func ProxyServer(proxy string) ExecAllocatorOption

ProxyServer is the command line option to set the outbound proxy server.

func UserAgent 

func UserAgent(userAgent string) ExecAllocatorOption

UserAgent is the command line option to set the default User-Agent header.

func UserDataDir 

func UserDataDir(dir string) ExecAllocatorOption

UserDataDir is the command line option to set the user data dir.

Note: set this option to manually set the profile directory used by Chrome. When this is not set, then a default path will be created in the /tmp directory.

func WindowSize 

func WindowSize(width, height int) ExecAllocatorOption

WindowSize is the command line option to set the initial window size.

type KeyOption 

type KeyOption func(*input.DispatchKeyEventParams) *input.DispatchKeyEventParams

KeyOption is a key action option.

func KeyModifiers 

func KeyModifiers(modifiers ...input.Modifier) KeyOption

KeyModifiers is a key action option to add additional modifiers on the key press.

type MouseOption 

type MouseOption func(*input.DispatchMouseEventParams) *input.DispatchMouseEventParams

MouseOption is a mouse action option.

func Button 

func Button(btn string) MouseOption

Button is a mouse action option to set the button to click from a string.

func ButtonModifiers 

func ButtonModifiers(modifiers ...input.Modifier) MouseOption

ButtonModifiers is a mouse action option to add additional input modifiers for a button click.

func ButtonType 

func ButtonType(button input.ButtonType) MouseOption

ButtonType is a mouse action option to set the button to click.

func ClickCount 

func ClickCount(n int) MouseOption

ClickCount is a mouse action option to set the click count.

type QueryOption 

type QueryOption func(*Selector)

QueryOption is a element query selector option.

func After 

func After(f func(context.Context, *Target, ...*cdp.Node) error) QueryOption

After is a query option to set a func that will be executed after the wait has succeeded.

func AtLeast 

func AtLeast(n int) QueryOption

AtLeast is a query option to wait until at least n elements are returned from the query selector.

func ByFunc 

func ByFunc(f func(context.Context, *Target, *cdp.Node) ([]cdp.NodeID, error)) QueryOption

ByFunc is a query option to set the func used to select elements.

func WaitFunc 

func WaitFunc(wait func(context.Context, *Target, *cdp.Frame, ...cdp.NodeID) ([]*cdp.Node, error)) QueryOption

WaitFunc is a query option to set a custom wait func.

type Selector 

type Selector struct {
	// contains filtered or unexported fields
}

Selector holds information pertaining to an element query select action.

func (*Selector) Do 

func (s *Selector) Do(ctx context.Context, h cdp.Executor) error

Do satisfies the Action interface.

type Target 

type Target struct {
	SessionID target.SessionID
	TargetID  target.ID
	OnEvent   EventFunc
	// contains filtered or unexported fields
}

Target manages a Chrome DevTools Protocol target.

func (*Target) Execute 

func (t *Target) Execute(ctx context.Context, method string, params json.Marshaler, res json.Unmarshaler) error

type TargetOption 

type TargetOption func(*Target)

type Tasks 

type Tasks []Action

Tasks is a sequential list of Actions that can be used as a single Action.

func SendKeysWait 

func SendKeysWait(sel string, s string, waitTime func() time.Duration) (t Tasks)

SendKeysWait is like SendKeys but sleeps for waitTime() between key presses

func (Tasks) Do 

func (t Tasks) Do(ctx context.Context, h cdp.Executor) error

Do executes the list of Actions sequentially, using the provided context and frame handler.

type Transport 

type Transport interface {
	Read() (*cdproto.Message, error)
	Write(*cdproto.Message) error
	io.Closer
}

Transport is the common interface to send/receive messages to a target.

Source Files

View all Source files

Directories

Path Synopsis
Package cdproto provides the Chrome DevTools Protocol commands, types, and events for the cdproto domain.
 Package cdproto provides the Chrome DevTools Protocol commands, types, and events for the cdproto domain.
accessibility
Package accessibility provides the Chrome DevTools Protocol commands, types, and events for the Accessibility domain.
 Package accessibility provides the Chrome DevTools Protocol commands, types, and events for the Accessibility domain.
animation
Package animation provides the Chrome DevTools Protocol commands, types, and events for the Animation domain.
 Package animation provides the Chrome DevTools Protocol commands, types, and events for the Animation domain.
applicationcache
Package applicationcache provides the Chrome DevTools Protocol commands, types, and events for the ApplicationCache domain.
 Package applicationcache provides the Chrome DevTools Protocol commands, types, and events for the ApplicationCache domain.
audits
Package audits provides the Chrome DevTools Protocol commands, types, and events for the Audits domain.
 Package audits provides the Chrome DevTools Protocol commands, types, and events for the Audits domain.
backgroundservice
Package backgroundservice provides the Chrome DevTools Protocol commands, types, and events for the BackgroundService domain.
 Package backgroundservice provides the Chrome DevTools Protocol commands, types, and events for the BackgroundService domain.
browser
Package browser provides the Chrome DevTools Protocol commands, types, and events for the Browser domain.
 Package browser provides the Chrome DevTools Protocol commands, types, and events for the Browser domain.
cachestorage
Package cachestorage provides the Chrome DevTools Protocol commands, types, and events for the CacheStorage domain.
 Package cachestorage provides the Chrome DevTools Protocol commands, types, and events for the CacheStorage domain.
cast
Package cast provides the Chrome DevTools Protocol commands, types, and events for the Cast domain.
 Package cast provides the Chrome DevTools Protocol commands, types, and events for the Cast domain.
cdp
css
Package css provides the Chrome DevTools Protocol commands, types, and events for the CSS domain.
 Package css provides the Chrome DevTools Protocol commands, types, and events for the CSS domain.
database
Package database provides the Chrome DevTools Protocol commands, types, and events for the Database domain.
 Package database provides the Chrome DevTools Protocol commands, types, and events for the Database domain.
debugger
Package debugger provides the Chrome DevTools Protocol commands, types, and events for the Debugger domain.
 Package debugger provides the Chrome DevTools Protocol commands, types, and events for the Debugger domain.
deviceorientation
Package deviceorientation provides the Chrome DevTools Protocol commands, types, and events for the DeviceOrientation domain.
 Package deviceorientation provides the Chrome DevTools Protocol commands, types, and events for the DeviceOrientation domain.
dom
Package dom provides the Chrome DevTools Protocol commands, types, and events for the DOM domain.
 Package dom provides the Chrome DevTools Protocol commands, types, and events for the DOM domain.
domdebugger
Package domdebugger provides the Chrome DevTools Protocol commands, types, and events for the DOMDebugger domain.
 Package domdebugger provides the Chrome DevTools Protocol commands, types, and events for the DOMDebugger domain.
domsnapshot
Package domsnapshot provides the Chrome DevTools Protocol commands, types, and events for the DOMSnapshot domain.
 Package domsnapshot provides the Chrome DevTools Protocol commands, types, and events for the DOMSnapshot domain.
domstorage
Package domstorage provides the Chrome DevTools Protocol commands, types, and events for the DOMStorage domain.
 Package domstorage provides the Chrome DevTools Protocol commands, types, and events for the DOMStorage domain.
emulation
Package emulation provides the Chrome DevTools Protocol commands, types, and events for the Emulation domain.
 Package emulation provides the Chrome DevTools Protocol commands, types, and events for the Emulation domain.
fetch
Package fetch provides the Chrome DevTools Protocol commands, types, and events for the Fetch domain.
 Package fetch provides the Chrome DevTools Protocol commands, types, and events for the Fetch domain.
har
Package har provides the Chrome DevTools Protocol commands, types, and events for the HAR domain.
 Package har provides the Chrome DevTools Protocol commands, types, and events for the HAR domain.
headlessexperimental
Package headlessexperimental provides the Chrome DevTools Protocol commands, types, and events for the HeadlessExperimental domain.
 Package headlessexperimental provides the Chrome DevTools Protocol commands, types, and events for the HeadlessExperimental domain.
heapprofiler
Package heapprofiler provides the Chrome DevTools Protocol commands, types, and events for the HeapProfiler domain.
 Package heapprofiler provides the Chrome DevTools Protocol commands, types, and events for the HeapProfiler domain.
indexeddb
Package indexeddb provides the Chrome DevTools Protocol commands, types, and events for the IndexedDB domain.
 Package indexeddb provides the Chrome DevTools Protocol commands, types, and events for the IndexedDB domain.
input
Package input provides the Chrome DevTools Protocol commands, types, and events for the Input domain.
 Package input provides the Chrome DevTools Protocol commands, types, and events for the Input domain.
inspector
Package inspector provides the Chrome DevTools Protocol commands, types, and events for the Inspector domain.
 Package inspector provides the Chrome DevTools Protocol commands, types, and events for the Inspector domain.
io
Package io provides the Chrome DevTools Protocol commands, types, and events for the IO domain.
 Package io provides the Chrome DevTools Protocol commands, types, and events for the IO domain.
layertree
Package layertree provides the Chrome DevTools Protocol commands, types, and events for the LayerTree domain.
 Package layertree provides the Chrome DevTools Protocol commands, types, and events for the LayerTree domain.
log
Package log provides the Chrome DevTools Protocol commands, types, and events for the Log domain.
 Package log provides the Chrome DevTools Protocol commands, types, and events for the Log domain.
memory
Package memory provides the Chrome DevTools Protocol commands, types, and events for the Memory domain.
 Package memory provides the Chrome DevTools Protocol commands, types, and events for the Memory domain.
network
Package network provides the Chrome DevTools Protocol commands, types, and events for the Network domain.
 Package network provides the Chrome DevTools Protocol commands, types, and events for the Network domain.
overlay
Package overlay provides the Chrome DevTools Protocol commands, types, and events for the Overlay domain.
 Package overlay provides the Chrome DevTools Protocol commands, types, and events for the Overlay domain.
page
Package page provides the Chrome DevTools Protocol commands, types, and events for the Page domain.
 Package page provides the Chrome DevTools Protocol commands, types, and events for the Page domain.
performance
Package performance provides the Chrome DevTools Protocol commands, types, and events for the Performance domain.
 Package performance provides the Chrome DevTools Protocol commands, types, and events for the Performance domain.
profiler
Package profiler provides the Chrome DevTools Protocol commands, types, and events for the Profiler domain.
 Package profiler provides the Chrome DevTools Protocol commands, types, and events for the Profiler domain.
runtime
Package runtime provides the Chrome DevTools Protocol commands, types, and events for the Runtime domain.
 Package runtime provides the Chrome DevTools Protocol commands, types, and events for the Runtime domain.
security
Package security provides the Chrome DevTools Protocol commands, types, and events for the Security domain.
 Package security provides the Chrome DevTools Protocol commands, types, and events for the Security domain.
serviceworker
Package serviceworker provides the Chrome DevTools Protocol commands, types, and events for the ServiceWorker domain.
 Package serviceworker provides the Chrome DevTools Protocol commands, types, and events for the ServiceWorker domain.
storage
Package storage provides the Chrome DevTools Protocol commands, types, and events for the Storage domain.
 Package storage provides the Chrome DevTools Protocol commands, types, and events for the Storage domain.
systeminfo
Package systeminfo provides the Chrome DevTools Protocol commands, types, and events for the SystemInfo domain.
 Package systeminfo provides the Chrome DevTools Protocol commands, types, and events for the SystemInfo domain.
target
Package target provides the Chrome DevTools Protocol commands, types, and events for the Target domain.
 Package target provides the Chrome DevTools Protocol commands, types, and events for the Target domain.
tethering
Package tethering provides the Chrome DevTools Protocol commands, types, and events for the Tethering domain.
 Package tethering provides the Chrome DevTools Protocol commands, types, and events for the Tethering domain.
tracing
Package tracing provides the Chrome DevTools Protocol commands, types, and events for the Tracing domain.
 Package tracing provides the Chrome DevTools Protocol commands, types, and events for the Tracing domain.
Package kb provides keyboard mappings for Chrome DOM Keys for use with input events.
 Package kb provides keyboard mappings for Chrome DOM Keys for use with input events.

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.