# go-selenium

**Repository Path**: laogg/go-selenium

## Basic Information

- **Project Name**: go-selenium
- **Description**: https://github.com/bunsenapp/go-selenium
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-20
- **Last Updated**: 2022-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# go-selenium

[![Build Status](https://travis-ci.org/bunsenapp/go-selenium.svg?branch=master)](https://travis-ci.org/bunsenapp/go-selenium)
[![GoDoc](https://godoc.org/github.com/bunsenapp/go-selenium?status.svg)](https://godoc.org/github.com/bunsenapp/go-selenium)
[![Go Report Card](https://goreportcard.com/badge/github.com/bunsenapp/go-selenium)](https://goreportcard.com/report/github.com/bunsenapp/go-selenium)

## 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](https://github.com/bunsenapp/go-selenium/blob/master/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](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`.