Skip to content

bunsenapp/go-selenium

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.