• Stars
    star
    162
  • Rank 232,284 (Top 5 %)
  • Language
    Go
  • License
    MIT License
  • Created almost 8 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Selenium web driver library written in Go

go-selenium

Build Status GoDoc Go Report Card

Maintainer Required

This package is no longer maintained. The author no longer writes automated tests with Selenium, and will only fix this package should there be a major security issue.

If you or someone you know is interested in maintaining this package, please raise an issue and tag me (@elsyms) in it.

Introduction

Yes, yet another Selenium Web Driver library has been brought to the table. This one, however, is slightly different.

  • Easy to understand.
  • Full test coverage by unit tests and integration tests.
  • Excellent support; we use this in our main project so if you find an issue - it'll likely impact us!
  • Idiomatic, structured code with no gimmicks.
  • Simple errors that describe what has happened and why.

Installation

As with all Go libraries, go-selenium is easy to install. Simply run the below command:

go get github.com/bunsenapp/go-selenium

and then import the library in your project:

import "github.com/bunsenapp/go-selenium"

Getting started

Prior to using this library you need to ensure that you have a Selenium instance running (standalone or grid is fine). If you don't know how to do this, there is a small section called 'Getting Selenium running' below.

Please see the examples/getting-started/main.go file.

Examples

Further examples, including tests of HackerNews (c), are available within the examples directory.

Documentation

All documentation is available on the godoc.org website: https://godoc.org/github.com/bunsenapp/go-selenium.

Getting Selenium running

With Docker

  1. Choose an image from the following URL: https://github.com/SeleniumHQ/docker-selenium
  2. Execute the following Docker command replacing the image with your chosen one: docker run -d -p 4444:4444 --name selenium selenium/standalone-firefox.

Without Docker

  1. Download the Selenium standalone server from the following URL: http://www.seleniumhq.org/download/
  2. Download the appropriate web driver executable and include it in your path. For Firefox, that will be the Gecko driver.
  3. Run the Selenium server with the following command: java -jar selenium-server-standalone-3.0.1.jar.