Provides behavior for retrying and discarding jobs on exceptions.
Namespace
Module
Methods
Instance Public methods
retry_job(options = {})
Reschedules the job to be re-executed. This is useful in combination with rescue_from. When you rescue an exception from your job you can ask Active Job to retry performing your job.
Options
-
:wait- Enqueues the job with the specified delay in seconds -
:wait_until- Enqueues the job at the time specified -
:queue- Enqueues the job on the specified queue -
:priority- Enqueues the job with the specified priority
Examples
class SiteScraperJob < ActiveJob::Base
rescue_from(ErrorLoadingSite) do
retry_job queue: :low_priority
end
def perform(*args)
# raise ErrorLoadingSite if cannot scrape
end
end
📝 Source code
# File activejob/lib/active_job/exceptions.rb, line 151
def retry_job(options = {})
instrument :enqueue_retry, options.slice(:error, :wait) do
enqueue options
end
end