aboutsummaryrefslogtreecommitdiffstats
path: root/guides
diff options
context:
space:
mode:
authoreileencodes <eileencodes@gmail.com>2017-02-20 14:38:46 -0500
committereileencodes <eileencodes@gmail.com>2017-02-20 15:07:35 -0500
commit2d61c5d846f8dd3a02080fedce7ab63b8d314db6 (patch)
tree0b534cf1fc2f9996fac26392cc0f673e904ac65c /guides
parent161cf89e134267f9b579f493ca19b12c30d5fd36 (diff)
downloadrails-2d61c5d846f8dd3a02080fedce7ab63b8d314db6.tar.gz
rails-2d61c5d846f8dd3a02080fedce7ab63b8d314db6.tar.bz2
rails-2d61c5d846f8dd3a02080fedce7ab63b8d314db6.zip
Rename system_test_helper -> application_system_test_case
This renames the system test helper file to be application system test case to match what the rest of Rails does. In the future we should consider changing the test_helper to match.
Diffstat (limited to 'guides')
-rw-r--r--guides/source/testing.md24
1 files changed, 12 insertions, 12 deletions
diff --git a/guides/source/testing.md b/guides/source/testing.md
index 366ab0b2a1..fe0dbf6c50 100644
--- a/guides/source/testing.md
+++ b/guides/source/testing.md
@@ -34,7 +34,7 @@ Rails creates a `test` directory for you as soon as you create a Rails project u
```bash
$ ls -F test
controllers/ helpers/ mailers/ system/ test_helper.rb
-fixtures/ integration/ models/ system_test_helper.rb
+fixtures/ integration/ models/ application_system_test_case.rb
```
The `helpers`, `mailers`, and `models` directories are meant to hold tests for view helpers, mailers, and models, respectively. The `controllers` directory is meant to hold tests for controllers, routes, and views. The `integration` directory is meant to hold tests for interactions between controllers.
@@ -51,7 +51,7 @@ A `jobs` directory will also be created when an associated test is first generat
The `test_helper.rb` file holds the default configuration for your tests.
-The `system_test_helper.rb` holds the default configuration for your system
+The `application_system_test_case.rb` holds the default configuration for your system
tests.
@@ -618,12 +618,12 @@ $ bin/rails generate system_test users_create_test.rb
Here's what a freshly-generated system test looks like:
```ruby
-require "system_test_helper"
+require "application_system_test_case"
class UsersCreateTest < ApplicationSystemTestCase
- # test "the truth" do
- # assert true
- # end
+ visit users_url
+
+ assert_selector "h1", text: "Users"
end
```
@@ -636,14 +636,14 @@ section explains how to change the default settings.
Rails makes changing the default settings for system test very simple. All
the setup is abstracted away so you can focus on writing your tests.
-When you generate a new application or scaffold, a `system_test_helper.rb` file
+When you generate a new application or scaffold, a `application_system_test_case.rb` file
is created in the test directory. This is where all the configuration for your
system tests should live.
If you want to change the default settings you can simple change what the system
tests are "driven by". Say you want to change the driver from Selenium to
Poltergeist. First add the Poltergeist gem to your Gemfile. Then in your
-`system_test_helper.rb` file do the following:
+`application_system_test_case.rb` file do the following:
```ruby
require "test_helper"
@@ -672,7 +672,7 @@ be used for non-headless drivers like Selenium), `:on` for the port Puma should
use, and `:screen_size` to change the size of the screen for screenshots.
If your Capybara configuration requires more setup than provided by Rails, all
-of that configuration can be put into the `system_test_helper.rb` file provided
+of that configuration can be put into the `application_system_test_case.rb` file provided
by Rails.
Please see [Capybara's documentation](https://github.com/teamcapybara/capybara#setup)
@@ -685,7 +685,7 @@ This can be helpful for viewing the browser at the point a test failed, or
to view screenshots later for debugging.
Two methods are provided: `take_screenshot` and `take_failed_screenshot`.
-`take_failed_screenshot` is automatically included in the `system_test_helper.rb`
+`take_failed_screenshot` is automatically included in the `application_system_test_case.rb`
file and will take a screenshot only if the test fails.
The `take_screenshot` helper method can be included anywhere in your tests to
@@ -715,12 +715,12 @@ previous command we should see:
Now let's open that file and write our first assertion:
```ruby
-require "system_test_helper"
+require "application_system_test_case"
class UsersTest < ApplicationSystemTestCase
test "viewing the index" do
visit articles_path
- assert_text "h1", "Articles"
+ assert_selector "h1", text: "Articles"
end
end
```