selenium-chrome.cr

A handy and thin wrapper for selenium-webdriver-crystal.

• crystal: 0.32.0

Component

• Selenium Server (You must prepare)
  • server: docker selenium/standalone-chrome-debug:3.11.0
  • driver: chrome (bundled in above image)
• Selenium Client
  • driver: https://github.com/ysbaddaden/selenium-webdriver-crystal
  • helper: THIS REPOSITORY (provides handy dsl like find)
  • client: Please see "USAGE" and write as you like.

Prepare Server

The simplest way is

docker run -d -p 4444:4444 selenium/standalone-chrome:3.11.0

Usage

require "selenium-chrome"

session = Selenium::Chrome.new
session.open "https://github.com/maiha/selenium-chrome.cr"

session.find(css: "article>h1").text # => "selenium-chrome.cr"
session.find(css: "xxx")             # raises Selenium::WebElement::NotFound
session.find?(css: "xxx")            # => nil

session.close

async downloader

bytes = session.download(timeout: 60.seconds, interval: 3.seconds) {
  session.find(css: "a>img[name='csv']").click
}

• When no timeout parameter is given, Setting#download_timeout is used.
• When no interval parameter is given, Setting#download_interval is used.

sync finder

find! waits until it will appear. This is useful after a page transition or after the element has changed dynamically.

session.find("css:form").submit
session.find!("id:welcome")

API (Session)

Installation

Add this to your application's shard.yml:

dependencies:
  selenium-chrome:
    github: maiha/selenium-chrome.cr
    version: 1.6.0

Test

make test

Contributing

1. Fork it ( https://github.com/maiha/selenium-chrome.cr/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• maiha maiha - creator, maintainer