Rails - How do you test ActionMailer sent a specific email in tests
Ruby on-RailsUnit TestingActionmailerRuby on-Rails Problem Overview
Currently in my tests I do something like this to test if an email is queued to be sent
assert_difference('ActionMailer::Base.deliveries.size', 1) do
get :create_from_spreedly, {:user_id => @logged_in_user.id}
end
but if i a controller action can send two different emails i.e. one to the user if sign up goes fine or a notification to admin if something went wrong - how can i test which one actually got sent. The code above would pass regardless.
Ruby on-Rails Solutions
Solution 1 - Ruby on-Rails
As of rails 3 ActionMailer::Base.deliveries is an array of Mail::Message's. From the mail documentation:
# mail['from'] = '[email protected]'
# mail[:to] = '[email protected]'
# mail.subject 'This is a test email'
# mail.body = 'This is a body'
#
# mail.to_s #=> "From: [email protected]\r\nTo: you@...
From that it should be easy to test your mail's in an integration
mail = ActionMailer::Base.deliveries.last
assert_equal '[email protected]', mail['from'].to_s
assert_equal '[email protected]', mail['to'].to_s
Solution 2 - Ruby on-Rails
When using the ActionMailer during tests, all mails are put in a big array called deliveries
. What you basically are doing (and is sufficient mostly) is checking if emails are present in the array.
But if you want to specifically check for a certain email, you have to know what is actually stored in the array. Luckily the emails themselves are stored, thus you are able to iterate through the array and check each email.
See ActionMailer::Base to see what configuration methods are available, which you can use to determine what emails are present in the array. Some of the most suitable methods for your case probably are
recipients
: Takes one or more email addresses. These addresses are where your email will be delivered to. Sets the To: header.subject
: The subject of your email. Sets the Subject: header.
Solution 3 - Ruby on-Rails
Using current Rspec syntax, I ended up using the following:
last_email = ActionMailer::Base.deliveries.last
expect(last_email.to).to eq ['[email protected]']
expect(last_email.subject).to have_content 'Welcome'
The context of my test was a feature spec where I wanted to make sure a welcome email was sent to a user after signing up.
Solution 4 - Ruby on-Rails
As of 2020 (Rails 6 era, probably introduced earlier) you can do the following:
(using a SystemTest example) TL;DR: use assert_emails
from ActionMailer::TestHelper
and ActionMailer::Base.deliveries.last
to access the mail itself.
require "application_system_test_case"
require 'test_helper'
require 'action_mailer/test_helper'
class ContactTest < ApplicationSystemTestCase
include ActionMailer::TestHelper
test "Send mail via contact form on landing page" do
visit root_url
fill_in "Message", with: 'message text'
# Asserting a mail is sent
assert_emails 1 do
click_on "Send"
end
# Asserting stuff within that mail
last_email = ActionMailer::Base.deliveries.last
assert_equal ['whatever'], last_email.reply_to
assert_equal "contact", last_email.subject
assert_match /Mail from someone/, last_email.body.to_s
end
end
Official doc:
Note Instead of manually checking the content of the mail as in the system test above, you can also test whether a specific mailer action was used, like this:
assert_enqueued_email_with ContactMailer, :welcome, args: ["Hello", "Goodbye"]
And some other handy assertion, see https://api.rubyonrails.org/v6.0.3.2/classes/ActionMailer/TestHelper.html#method-i-assert_emails .
Solution 5 - Ruby on-Rails
The test framework shoulda has an excellent helper which lets you assert certain conditions about an email that was sent. Yes, you could do it yourself with ActionMailer.deliveries, but shoulda makes it all one neat little block
Solution 6 - Ruby on-Rails
A little late, but it may help others:
You could use Email-spec, a collection of Rspec/Minitest matchers and Cucumber steps.
Solution 7 - Ruby on-Rails
Here is the best way I've found to do it.
-
Include the action mailer callbacks plugin like this:
script/plugin install git://github.com/AnthonyCaliendo/action_mailer_callbacks.git
I don't really use the plugin's main features, but it does provide the nice functionality of being able to figure out which method was used to send an email.
-
Now you can put some methods in your test_helper.rb like this:
def assert_sent(method_name) assert sent_num_times(method_name) > 0 end
def assert_not_sent(method_name) assert sent_num_times(method_name) == 0 end
def assert_sent_once(method_name) assert sent_num_times(method_name) == 1 end
def sent_num_times(method_name) count = 0 @emails.each do |email| count += 1 if method_name == email.instance_variable_get("@method_name") end count end
-
Now you can write sweet tests like this:
require 'test_helper' class MailingTest < ActionController::IntegrationTest
def setup @emails = ActionMailer::Base.deliveries @emails.clear end
test "should send a mailing" do assert_difference "Mailing.count", 1 do feeds(:feed1).generate_mailing end
assert_sent_once "broadcast" assert_not_sent "failed_mailing"
end end
Here "broadcast" and "mailing_failed" are the names of the methods in my ActionMailer::Base class. These are the ones you normally use by calling Mailer.deliver_broadcast(some_data)
or Mailer.deliver_failed_mailing(some_data)
etc. That's it!