メインコンテンツまでスキップ

have_performed_job マッチャー

have_performed_job(または perform_job としてもエイリアスされる)マッチャーは、指定された ActiveJob ジョブが実行されたかどうかをチェックするために使用されます。

背景

アクティブなジョブが利用可能であることが前提です。

ジョブクラス名のチェック

"spec/jobs/upload_backups_job_spec.rb" という名前のファイルがあるとします。

require "rails_helper"

RSpec.describe UploadBackupsJob do
it "matches with performed job" do
ActiveJob::Base.queue_adapter = :test
ActiveJob::Base.queue_adapter.perform_enqueued_jobs = true
expect {
UploadBackupsJob.perform_later
}.to have_performed_job(UploadBackupsJob)
end
end

rspec spec/jobs/upload_backups_job_spec.rb を実行すると、

すべての例がパスするはずです。

渡された引数のジョブのチェック

"spec/jobs/upload_backups_job_spec.rb" という名前のファイルがあるとします。

require "rails_helper"

RSpec.describe UploadBackupsJob do
it "matches with performed job" do
ActiveJob::Base.queue_adapter = :test
ActiveJob::Base.queue_adapter.perform_enqueued_jobs = true
expect {
UploadBackupsJob.perform_later("users-backup.txt", "products-backup.txt")
}.to have_performed_job.with("users-backup.txt", "products-backup.txt")
end
end

rspec spec/jobs/upload_backups_job_spec.rb を実行すると、

すべての例がパスするはずです。

ジョブの実行時間のチェック

"spec/jobs/upload_backups_job_spec.rb" という名前のファイルがあるとします。

require "rails_helper"

RSpec.describe UploadBackupsJob do
it "matches with performed job" do
ActiveJob::Base.queue_adapter = :test
ActiveJob::Base.queue_adapter.perform_enqueued_jobs = true
ActiveJob::Base.queue_adapter.perform_enqueued_at_jobs = true
expect {
UploadBackupsJob.set(:wait_until => Date.tomorrow.noon).perform_later
}.to have_performed_job.at(Date.tomorrow.noon)
end
end

rspec spec/jobs/upload_backups_job_spec.rb を実行すると、

すべての例がパスするはずです。

ジョブキュー名のチェック

"spec/jobs/upload_backups_job_spec.rb" という名前のファイルがあるとします。

require "rails_helper"

RSpec.describe UploadBackupsJob do
it "matches with performed job" do
ActiveJob::Base.queue_adapter = :test
ActiveJob::Base.queue_adapter.perform_enqueued_jobs = true
expect {
UploadBackupsJob.perform_later
}.to have_performed_job.on_queue("default")
end
end

rspec spec/jobs/upload_backups_job_spec.rb を実行すると、

すべての例がパスするはずです。

エイリアスメソッドの使用

"spec/jobs/upload_backups_job_spec.rb" という名前のファイルがあるとします。

require "rails_helper"

RSpec.describe UploadBackupsJob do
it "matches with performed job" do
ActiveJob::Base.queue_adapter = :test
ActiveJob::Base.queue_adapter.perform_enqueued_jobs = true
expect {
UploadBackupsJob.perform_later
}.to perform_job(UploadBackupsJob)
end
end

rspec spec/jobs/upload_backups_job_spec.rb を実行すると、

すべての例がパスするはずです。