aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source
diff options
context:
space:
mode:
authorTom Rossi <tom@higherpixels.com>2018-11-25 16:57:59 -0500
committerTom Rossi <tom@higherpixels.com>2018-11-25 16:57:59 -0500
commitee8dce180e8d659d879504fd051c3132af9cc8b7 (patch)
treec312c388d3d68f588f5625c73f872c43ce9d9ef3 /guides/source
parentd6fcc419fe4f99d3f9414d39d081bd6355842018 (diff)
downloadrails-ee8dce180e8d659d879504fd051c3132af9cc8b7.tar.gz
rails-ee8dce180e8d659d879504fd051c3132af9cc8b7.tar.bz2
rails-ee8dce180e8d659d879504fd051c3132af9cc8b7.zip
Updating the Testing Guide to Reflect Emails Enqueued With ActiveJob [ci skip]
Diffstat (limited to 'guides/source')
-rw-r--r--guides/source/testing.md30
1 files changed, 23 insertions, 7 deletions
diff --git a/guides/source/testing.md b/guides/source/testing.md
index 8c21ccfba6..f0a1a8a3f0 100644
--- a/guides/source/testing.md
+++ b/guides/source/testing.md
@@ -1593,27 +1593,43 @@ NOTE: The `ActionMailer::Base.deliveries` array is only reset automatically in
If you want to have a clean slate outside these test cases, you can reset it
manually with: `ActionMailer::Base.deliveries.clear`
-### Functional Testing
+### Functional and System Testing
-Functional testing for mailers involves more than just checking that the email body, recipients, and so forth are correct. In functional mail tests you call the mail deliver methods and check that the appropriate emails have been appended to the delivery list. It is fairly safe to assume that the deliver methods themselves do their job. You are probably more interested in whether your own business logic is sending emails when you expect them to go out. For example, you can check that the invite friend operation is sending an email appropriately:
+Unit testing allows us to test the attributes of the email while functional and system testing allows us to test whether user interactions appropriately trigger the email to be delivered. For example, you can check that the invite friend operation is sending an email appropriately:
```ruby
+# Integration Test
require 'test_helper'
class UsersControllerTest < ActionDispatch::IntegrationTest
test "invite friend" do
- assert_difference 'ActionMailer::Base.deliveries.size', +1 do
+ # Asserts the difference in the ActionMailer::Base.deliveries
+ assert_emails 1 do
post invite_friend_url, params: { email: 'friend@example.com' }
end
- invite_email = ActionMailer::Base.deliveries.last
+ end
+end
+```
+
+```ruby
+# System Test
+require 'test_helper'
+
+class UsersTest < ActionDispatch::SystemTestCase
+ driven_by :selenium, using: :headless_chrome
- assert_equal "You have been invited by me@example.com", invite_email.subject
- assert_equal 'friend@example.com', invite_email.to[0]
- assert_match(/Hi friend@example\.com/, invite_email.body.to_s)
+ test "inviting a friend" do
+ visit invite_users_url
+ fill_in 'Email', with: 'friend@example.com'
+ assert_emails 1 do
+ click_on 'Invite'
+ end
end
end
```
+NOTE: The `assert_emails` method is not tied to a particular deliver method and will work with emails delivered with either the `deliver_now` or `deliver_later` method. If we explicitly want to assert that the email has been enqueued we can use the `assert_enqueued_emails` method. More information can be found in the [documentation here](https://api.rubyonrails.org/classes/ActionMailer/TestHelper.html).
+
Testing Jobs
------------