chr

README

CHR

GO语言跨平台驱动chrome内核浏览器,实现自动化操作。

Require

• Go >= 1.11
• Chromium >= 69

支持

• Mac Os
• Linux
• Windows

Documentation

Index

• type Browser
  • func Create(options ...Option) (*Browser, error)
  • func (chrome *Browser) Close() error
  • func (chrome *Browser) Find(kw string) (*Tab, error)
  • func (chrome *Browser) Open(url string) (*Tab, error)
• type Error
• type Event
• type Option
  • func WithChrome(bin string) Option
  • func WithDataDir(dir string) Option
  • func WithRemoteAddr(addr string) Option
  • func WithTimeout(d time.Duration) Option
• type Return
• type Tab
  • func (tab *Tab) Capture(filename string, quality int, viewport page.Viewport) error
  • func (tab *Tab) Check(selector string, checked bool) error
  • func (tab *Tab) Click(selector string) error
  • func (tab *Tab) Close() error
  • func (tab *Tab) HandleEvent(method string, params interface{}) error
  • func (tab *Tab) HandleResult(returns interface{}) error
  • func (tab *Tab) Input(selector, v string) error
  • func (tab *Tab) Js(js string, timeout runtime.TimeDelta) (object runtime.RemoteObject, err error)
  • func (tab *Tab) Jump(url string) error
  • func (tab *Tab) Query(selector string) ([]dom.NodeId, error)
  • func (tab *Tab) Refresh() error
  • func (tab *Tab) Select(selector, v string) error
  • func (tab *Tab) Send(method string, params interface{}) error
  • func (tab *Tab) Text(selector string) string
  • func (tab *Tab) Value(selector string) string
  • func (tab *Tab) Wait() error

Types

type Browser

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

func Create

func Create(options ...Option) (*Browser, error)

Create chrome client

func (*Browser) Close

func (chrome *Browser) Close() error

Close chrome

func (*Browser) Find

func (chrome *Browser) Find(kw string) (*Tab, error)

Catch tab

func (*Browser) Open

func (chrome *Browser) Open(url string) (*Tab, error)

Open new tab

type Error

type Error struct {
	Id    int
	Error struct {
		Code    int
		Data    string
		Message string
	}
}

type Event

type Event struct {
	Method string
	Params interface{}
}

type Option

type Option func(b *Browser)

func WithChrome

func WithChrome(bin string) Option

func WithDataDir

func WithDataDir(dir string) Option

func WithRemoteAddr

func WithRemoteAddr(addr string) Option

func WithTimeout

func WithTimeout(d time.Duration) Option

type Return

type Return struct {
	Id     int
	Result interface{}
}

type Tab

type Tab struct {
	Id                   string `json:"id"`
	Url                  string `json:"url"`
	Type                 string `json:"type"`
	Title                string `json:"title"`
	DevtoolsFrontendUrl  string `json:"devtoolsFrontendUrl"`
	WebSocketDebuggerUrl string `json:"webSocketDebuggerUrl"`
	Ipc                  ipc    `json:"-"`
}

func (*Tab) Capture

func (tab *Tab) Capture(filename string, quality int, viewport page.Viewport) error

页面截图

func (*Tab) Check

func (tab *Tab) Check(selector string, checked bool) error

选择

func (*Tab) Click

func (tab *Tab) Click(selector string) error

元素点击

func (*Tab) Close

func (tab *Tab) Close() error

关闭标签

func (*Tab) HandleEvent

func (tab *Tab) HandleEvent(method string, params interface{}) error

func (*Tab) HandleResult

func (tab *Tab) HandleResult(returns interface{}) error

func (*Tab) Input

func (tab *Tab) Input(selector, v string) error

输入值

func (*Tab) Js

func (tab *Tab) Js(js string, timeout runtime.TimeDelta) (object runtime.RemoteObject, err error)

运行Javascript

func (*Tab) Jump

func (tab *Tab) Jump(url string) error

跳转地址

func (*Tab) Query

func (tab *Tab) Query(selector string) ([]dom.NodeId, error)

查询节点

func (*Tab) Refresh

func (tab *Tab) Refresh() error

页面刷新

func (*Tab) Select

func (tab *Tab) Select(selector, v string) error

下拉框

func (*Tab) Send

func (tab *Tab) Send(method string, params interface{}) error

发起命令

func (*Tab) Text

func (tab *Tab) Text(selector string) string

获取文本信息

func (*Tab) Value

func (tab *Tab) Value(selector string) string

元素值

func (*Tab) Wait

func (tab *Tab) Wait() error

等待页面加载完成