aboutsummaryrefslogtreecommitdiffstats
path: root/actionsystemtest/lib/action_system_test.rb
blob: 18b992a3ca8d401b39d536cada229ead985b050b (plain) (blame)
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
45
46
47
48
49
50
51
52
53
54
55
56
57
require "action_system_test/test_helper"
require "action_system_test/driver_adapter"

# System tests are similar to Integration tests in that they incorporate multiple
# controllers and actions, but can be used to simulate a real user experience.
# System tests are also known as Acceptance tests.
#
# To create a System Test in your application extend your test class from
# <tt>ActionSystemTestCase</tt>. System tests use Capybara as a base and
# allows you to configure the driver. The default driver is
# <tt>RailsSeleniumDriver</tt> which provides Capybara with no-setup
# configuration of the Selenium Driver. If you prefer you can use the bare
# Selenium driver and set your own configuration.
#
# A system test looks like the following:
#
#   require 'test_helper'
#
#   class Users::CreateTest < ActionSystemTestCase
#     def adding_a_new_user
#       visit users_path
#       click_on 'New User'
#
#       fill_in 'Name', with: 'Arya'
#       click_on 'Create User'
#
#       assert_text 'Arya'
#     end
#   end
#
# System test driver can be configured in your Rails configuration file for the
# test environment.
#
#   config.system_testing.driver = :rails_selenium_driver
#
# You can also specify a driver by initializing a new driver object. This allows
# you to change the default settings for the driver you're setting.
#
#   config.system_testing.driver = ActionSystemTest::DriverAdapters::RailsSeleniumDriver.new(
#     browser: :firefox
#   )
#
# A list of supported adapters can be found in DriverAdapters.
#
# If you want to use one of the default drivers provided by Capybara you can
# set the driver in your config to one of those defaults: +:rack_test+,
# +:selenium+, +:webkit+, or +:poltergeist+. These 4 drivers use Capyara's
# driver defaults whereas the <tt>RailsSeleniumDriver</tt> has pre-set
# configuration for browser, server, port, etc.
module ActionSystemTest
  include ActionSystemTest::TestHelper
  include ActionSystemTest::DriverAdapter
end

class ActionSystemTestCase < ActionDispatch::IntegrationTest
  include ActionSystemTest
end