🌐 AI搜索 & 代理 主页
Google Git
Sign in
chromium / external / github.com / chromedp / chromedp / refs/tags/v0.5.1
commit8e0a16689423d48d8907c62a543c7ea468059228[log] [tgz]
authorKenneth Shaw <kenneth.shaw@knq.io>Sun Oct 13 01:15:02 2019
committerDaniel Martí <mvdan@mvdan.cc>Sun Oct 13 12:29:55 2019
treece526b15f4367c2fa61c0a04ed0d988f5fc03d82
parent230c1556673d34cc7a2f7f06ea1450d6fde8b386 [diff]
Fix concurrency issues

Intermittent timeouts on certain channel reads can occur, and not catch
when a context has been closed causing hangs and other potential issues.

This adds additional checks for when a context has been closed in a
first pass at fixing the fundamental issue.

Additionally, gets rid of the `raw{Marshal,Unmarshal}` calls, and
updates LICENSE.
6 files changed
tree: ce526b15f4367c2fa61c0a04ed0d988f5fc03d82
  1. .github/
  2. device/
  3. kb/
  4. testdata/
  5. .gitignore
  6. .travis.yml
  7. allocate.go
  8. allocate_linux.go
  9. allocate_other.go
  10. allocate_test.go
  11. browser.go
  12. chromedp.go
  13. chromedp_test.go
  14. conn.go
  15. emulate.go
  16. emulate_test.go
  17. errors.go
  18. eval.go
  19. event_test.go
  20. example_test.go
  21. go.mod
  22. go.sum
  23. input.go
  24. input_test.go
  25. js.go
  26. LICENSE
  27. nav.go
  28. nav_test.go
  29. query.go
  30. query_test.go
  31. README.md
  32. target.go
  33. util.go
  34. util_test.go
README.md

About chromedp GoDoc Build Status

Package chromedp is a faster, simpler way to drive browsers supporting the Chrome DevTools Protocol in Go without external dependencies (like Selenium or PhantomJS).

Installing

Install in the usual Go way:

go get -u github.com/chromedp/chromedp

Examples

Refer to the GoDoc page for the documentation and examples. Additionally, the examples repository contains more complex examples.

Frequently Asked Questions

I can't see any Chrome browser window

By default, Chrome is run in headless mode. See DefaultExecAllocatorOptions, and an example to override the default options.

I'm seeing “context canceled” errors

When the connection to the browser is lost, chromedp cancels the context, and it may result in this error. This occurs, for example, if the browser is closed manually, or if the browser process has been killed or otherwise terminated.

Chrome exits as soon as my Go program finishes

On Linux, chromedp is configured to avoid leaking resources by force-killing any started Chrome child processes. If you need to launch a long-running Chrome instance, manually start Chrome and connect using RemoteAllocator.

Executing an action without Run results in “invalid context”

By default, a chromedp context does not have an executor, however one can be specified manually if necessary; see issue #326 for an example.

I can't use an Action with Run because it returns many values

Wrap it with an ActionFunc:

chromedp.Run(ctx, chromedp.ActionFunc(func(ctx context.Context) error {
	_, err := domain.SomeAction().Do(ctx)
	return err
}))

I want to use chromedp on a headless environment

The simplest way is to run the Go program that uses chromedp inside the chromedp/headless-shell image. That image contains headless-shell, a smaller headless build of Chrome, which chromedp is able to find out of the box.

Resources