Capybara Tutorial

Getting Started with Applitools

Want to learn more about the Applitools platform and how it works? First get started with one of the following:

Running Tests with Applitools

Prerequisites
  1. A free Applitools account and Applitools API KEY

Tip: Unsure how to set up your API key?

Learn how to get started at Setting Up

  1. Ruby https://www.ruby-lang.org/en/documentation/installation/

  2. Git https://git-scm.com​

Note: Installing `git` is optional

Installing git is used to clone the demo project from the Github repository. Instead of installing git, you can simply download the Zip file from the repository. Further, if you are Mac, you already have git.

  1. Google Chrome Browser https://www.google.com/chrome/

  2. ChromeDriver https://chromedriver.chromium.org/getting-started

ChromeDriver must be installed and in your `PATH`

Below are some resources from the internet that'll help you

On Mac, place the chromedriver executable in /usr/local/bin folder so Eclipse and IntelliJ can find it.

Running the Example Project

  1. Clone or download the repository and navigate to that folder
git clone https://github.com/applitools/tutorial-capybara-ruby-basic.git
cd tutorial-capybara-ruby-basic
1
2

Note: you can alternatively download the project as a Zip file and extract it

  1. Install the dependencies
gem install bundler && bundle install
1
  1. Run the example test
APPLITOOLS_API_KEY="[Your API Key]" bundle exec ruby simple_test_script.rb
1

This will first set your APPLITOOLS_API_KEY into the node process then run bundle exec.

Adding Applitools Eyes to an Existing Project

Install Applitools Eyes dependencies:

gem install eyes_selenium
1

Sample test

require 'eyes_capybara'
require 'capybara/dsl'

extend Capybara::DSL

options = Selenium::WebDriver::Chrome::Options.new

runner = Applitools::ClassicRunner.new
batch = Applitools::BatchInfo.new('Demo Batch')
eyes = Applitools::Selenium::Eyes.new(runner: runner)

Applitools.register_capybara_driver :browser => :chrome, options:options

eyes.configure do |conf|
  conf.batch = batch
  conf.app_name = 'Demo App - capybara'
  conf.test_name = 'Smoke Test'
  conf.viewport_size = Applitools::RectangleSize.new(800, 600)
end

begin
  # Call Open on eyes to initialize a test session
  eyes.open(driver: page)

  # Navigate to the url we want to test
  visit('https://demo.applitools.com')

  # Note to see visual bugs, run the test using the above URL for the 1st run.
  # but then change the above URL to https://demo.applitools.com/index_v2.html (for the 2nd run)

  # check the login page
  eyes.check(name: 'Login window', target: Applitools::Selenium::Target.window.fully)

  # Click the 'Log In' button
  page.find(:id, 'log-in').click

  # Check the app page
  eyes.check(name: 'App Window', target: Applitools::Selenium::Target.window.fully)
  eyes.close
ensure
  eyes.abort_if_not_closed
  # Get and print all test results
  puts runner.get_all_test_results
end
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

More information

Resources




Terms & Conditions Privacy Policy GDPR© 2021 Applitools. All rights reserved.

Last Updated: 6/24/2021, 10:09:59 AM