Logo: Relish

  1. Sign in

Project: RSpec Rails 3.6

Publisher: RSpec

job spec

Job specs provide alternative assertions to those available in
ActiveJob::TestHelper and help assert behaviour of the jobs themselves
and that other entities correctly enqueue them.

Job specs are marked by :type => :job or if you have set
config.infer_spec_type_from_file_location! by placing them in spec/jobs.

With job specs, you can:

  • specify the job class which was enqueued
  • specify the arguments passed to the job
  • specify when the job was enqueued until
  • specify the queue which the job was enqueued to

Check the documentation on
have_been_enqueued and have_enqueued_job for more
information.

Background
Given
active job is available
Scenarios
  1. specify that job was enqueued
  2. specify that job was enqueued for the correct date and time
  3. specify that job was enqueued with alias block syntax
  4. specify that job was enqueued with imperative syntax
  5. specify that job was enqueued with imperative syntax and a chained expectation
  6. the test adapter must be set to :test
specify that job was enqueued
Given
a file named "spec/jobs/upload_backups_spec.rb" with: 
require "rails_helper"

RSpec.describe UploadBackupsJob, :type => :job do
  describe "#perform_later" do
    it "uploads a backup" do
      ActiveJob::Base.queue_adapter = :test
      expect {
        UploadBackupsJob.perform_later('backup')
      }.to have_enqueued_job
    end
  end
end
When
I run rspec spec/jobs/upload_backups_spec.rb
Then
the example should pass
specify that job was enqueued for the correct date and time
Given
a file named "spec/jobs/upload_backups_spec.rb" with: 
require "rails_helper"

RSpec.describe UploadBackupsJob, :type => :job do
  describe "#perform_later" do
    it "uploads a backup" do
      ActiveJob::Base.queue_adapter = :test
      expect {
        UploadBackupsJob.set(wait_until: Date.tomorrow.noon, queue: "low").perform_later('backup')
      }.to have_enqueued_job.with('backup').on_queue("low").at(Date.tomorrow.noon)
    end
  end
end
When
I run rspec spec/jobs/upload_backups_spec.rb
Then
the example should pass
specify that job was enqueued with alias block syntax
Given
a file named "spec/jobs/upload_backups_spec.rb" with: 
require "rails_helper"

RSpec.describe UploadBackupsJob, :type => :job do
  describe "#perform_later" do
    it "uploads a backup" do
      ActiveJob::Base.queue_adapter = :test
      expect {
        UploadBackupsJob.perform_later('backup')
      }.to enqueue_job
    end
  end
end
When
I run rspec spec/jobs/upload_backups_spec.rb
Then
the example should pass
specify that job was enqueued with imperative syntax
Given
a file named "spec/jobs/upload_backups_spec.rb" with: 
require "rails_helper"

RSpec.describe UploadBackupsJob, :type => :job do
  describe "#perform_later" do
    it "uploads a backup" do
      ActiveJob::Base.queue_adapter = :test
      UploadBackupsJob.perform_later('backup')
      expect(UploadBackupsJob).to have_been_enqueued
    end
  end
end
When
I run rspec spec/jobs/upload_backups_spec.rb
Then
the example should pass
specify that job was enqueued with imperative syntax and a chained expectation
Given
a file named "spec/jobs/upload_backups_spec.rb" with: 
require "rails_helper"

RSpec.describe UploadBackupsJob, :type => :job do
  describe "#perform_later" do
    it "uploads a backup" do
      ActiveJob::Base.queue_adapter = :test
      UploadBackupsJob.perform_later('backup')
      expect(UploadBackupsJob).to have_been_enqueued.exactly(:once)
    end
  end
end
When
I run rspec spec/jobs/upload_backups_spec.rb
Then
the example should pass
the test adapter must be set to :test
Given
a file named "spec/jobs/upload_backups_spec.rb" with: 
require "rails_helper"

RSpec.describe UploadBackupsJob, :type => :job do
  describe "#perform_later" do
    it "uploads a backup" do
      ActiveJob::Base.queue_adapter = :development
    end
  end
end
When
I run rspec spec/jobs/upload_backups_spec.rb
Then
the example should fail

Last published almost 6 years ago by myronmarston.