Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/playwright-community/playwright-go
Playwright for Go a browser automation library to control Chromium, Firefox and WebKit with a single API.
https://github.com/playwright-community/playwright-go
automation browser-automation chromium firefox go golang hacktoberfest headless headless-chrome playwright selenium webkit
Last synced: 5 days ago
JSON representation
Playwright for Go a browser automation library to control Chromium, Firefox and WebKit with a single API.
- Host: GitHub
- URL: https://github.com/playwright-community/playwright-go
- Owner: playwright-community
- License: mit
- Created: 2020-08-16T12:46:14.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-25T14:37:08.000Z (3 months ago)
- Last Synced: 2024-10-29T15:19:30.986Z (2 months ago)
- Topics: automation, browser-automation, chromium, firefox, go, golang, hacktoberfest, headless, headless-chrome, playwright, selenium, webkit
- Language: Go
- Homepage: https://playwright-community.github.io/playwright-go/
- Size: 31.2 MB
- Stars: 2,178
- Watchers: 29
- Forks: 160
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - playwright-community/playwright-go - Playwright for Go a browser automation library to control Chromium, Firefox and WebKit with a single API. (Go)
- awesome-playwright - playwright-go - Playwright port for Golang. (Language Support)
- awesome-golang-repositories - playwright-go
- awesome-go-extra - playwright-go - 08-16T12:46:14Z|2022-06-24T08:47:39Z| (Testing / Selenium and browser control tools.)
- awesome - playwright-community/playwright-go - Playwright for Go a browser automation library to control Chromium, Firefox and WebKit with a single API. (Go)
- awesome - playwright-community/playwright-go - Playwright for Go a browser automation library to control Chromium, Firefox and WebKit with a single API. (Go)
README
# 🎠[Playwright](https://github.com/microsoft/playwright#readme) for 
## Looking for maintainers and see [here](https://github.com/playwright-community/playwright-go/issues/122). Thanks!
[](https://pkg.go.dev/github.com/playwright-community/playwright-go)
[](http://opensource.org/licenses/MIT)
[](https://goreportcard.com/report/github.com/playwright-community/playwright-go) 
[](https://aka.ms/playwright-slack) [](https://coveralls.io/github/playwright-community/playwright-go?branch=main) [](https://www.chromium.org/Home) [](https://www.mozilla.org/en-US/firefox/new/) [](https://webkit.org/)
[API reference](https://playwright.dev/docs/api/class-playwright) | [Example recipes](https://github.com/playwright-community/playwright-go/tree/main/examples)
Playwright is a Go library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) with a single API. Playwright is built to enable cross-browser web automation that is **ever-green**, **capable**, **reliable** and **fast**.
| | Linux | macOS | Windows |
| :--- | :---: | :---: | :---: |
| Chromium 131.0.6778.33 | ✅ | ✅ | ✅ |
| WebKit 18.2 | ✅ | ✅ | ✅ |
| Firefox 132.0 | ✅ | ✅ | ✅ |
Headless execution is supported for all the browsers on all platforms.
## Installation
```txt
go get -u github.com/playwright-community/playwright-go
```
Install the browsers and OS dependencies:
```bash
go run github.com/playwright-community/playwright-go/cmd/playwright@latest install --with-deps
# Or
go install github.com/playwright-community/playwright-go/cmd/playwright@latest
playwright install --with-deps
```
Alternatively you can do it inside your program via which downloads the driver and browsers:
```go
err := playwright.Install()
```
## Capabilities
Playwright is built to automate the broad and growing set of web browser capabilities used by Single Page Apps and Progressive Web Apps.
* Scenarios that span multiple page, domains and iframes
* Auto-wait for elements to be ready before executing actions (like click, fill)
* Intercept network activity for stubbing and mocking network requests
* Emulate mobile devices, geolocation, permissions
* Support for web components via shadow-piercing selectors
* Native input events for mouse and keyboard
* Upload and download files
## Example
The following example crawls the current top voted items from [Hacker News](https://news.ycombinator.com).
```go
package main
import (
"fmt"
"log"
"github.com/playwright-community/playwright-go"
)
func main() {
pw, err := playwright.Run()
if err != nil {
log.Fatalf("could not start playwright: %v", err)
}
browser, err := pw.Chromium.Launch()
if err != nil {
log.Fatalf("could not launch browser: %v", err)
}
page, err := browser.NewPage()
if err != nil {
log.Fatalf("could not create page: %v", err)
}
if _, err = page.Goto("https://news.ycombinator.com"); err != nil {
log.Fatalf("could not goto: %v", err)
}
entries, err := page.Locator(".athing").All()
if err != nil {
log.Fatalf("could not get entries: %v", err)
}
for i, entry := range entries {
title, err := entry.Locator("td.title > span > a").TextContent()
if err != nil {
log.Fatalf("could not get text content: %v", err)
}
fmt.Printf("%d: %s\n", i+1, title)
}
if err = browser.Close(); err != nil {
log.Fatalf("could not close browser: %v", err)
}
if err = pw.Stop(); err != nil {
log.Fatalf("could not stop Playwright: %v", err)
}
}
```
## Docker
Refer to the [Dockerfile.example](./Dockerfile.example) to build your own docker image.
## More examples
* Refer to [helper_test.go](./tests/helper_test.go) for End-To-End testing
* [Downloading files](./examples/download/main.go)
* [End-To-End testing a website](./examples/end-to-end-testing/main.go)
* [Executing JavaScript in the browser](./examples/javascript/main.go)
* [Emulate mobile and geolocation](./examples/mobile-and-geolocation/main.go)
* [Parallel scraping using a WaitGroup](./examples/parallel-scraping/main.go)
* [Rendering a PDF of a website](./examples/pdf/main.go)
* [Scraping HackerNews](./examples/scraping/main.go)
* [Take a screenshot](./examples/screenshot/main.go)
* [Record a video](./examples/video/main.go)
* [Monitor network activity](./examples/network-monitoring/main.go)
## How does it work?
Playwright is a Node.js library which uses:
* Chrome DevTools Protocol to communicate with Chromium
* Patched Firefox to communicate with Firefox
* Patched WebKit to communicate with WebKit
These patches are based on the original sources of the browsers and don't modify the browser behaviour so the browsers are basically the same (see [here](https://github.com/microsoft/playwright/tree/main/browser_patches)) as you see them in the wild. The support for different programming languages is based on exposing a RPC server in the Node.js land which can be used to allow other languages to use Playwright without implementing all the custom logic:
* [Playwright for Python](https://github.com/microsoft/playwright-python)
* [Playwright for .NET](https://github.com/microsoft/playwright-sharp)
* [Playwright for Java](https://github.com/microsoft/playwright-java)
* [Playwright for Go](https://github.com/playwright-community/playwright-go)
The bridge between Node.js and the other languages is basically a Node.js runtime combined with Playwright which gets shipped for each of these languages (around 50MB) and then communicates over stdio to send the relevant commands. This will also download the pre-compiled browsers.
## Is Playwright for Go ready?
We are ready for your feedback, but we are still covering Playwright Go with the tests.
## Resources
* [Playwright for Go Documentation](https://pkg.go.dev/github.com/playwright-community/playwright-go)
* [Playwright Documentation](https://playwright.dev/docs/api/class-playwright)
* [Example recipes](https://github.com/playwright-community/playwright-go/tree/main/examples)