Module: ActiveJob::Exceptions

Relationships & Source Files
Namespace Children
Modules: `ClassMethods`
Extension / Inclusion / Inheritance Descendants
Included In: ActionMailer::MailDeliveryJob, `Base`, `::ActiveRecord::DestroyAssociationAsyncJob`
Super Chains via Extension / Inclusion / Inheritance
Class Chain: self, `::ActiveSupport::Concern`
Defined in:	activejob/lib/active_job/exceptions.rb

Overview

Provides behavior for retrying and discarding jobs on exceptions.

Constant Summary

JITTER_DEFAULT = private
# File 'activejob/lib/active_job/exceptions.rb', line 164
```
Object.new
```

Class Method Summary

`::ActiveSupport::Concern` - Extended

class_methods	Define class methods from given block.
included	Evaluate given block in context of base class, so that you can write class macros here.
prepended	Evaluate given block in context of base class, so that you can write class macros here.

Instance Method Summary

#retry_job(options = {})

Reschedules the job to be re-executed.

DSL Calls

included

[ GitHub ]

# File 'activejob/lib/active_job/exceptions.rb', line 10


included do
  class_attribute :retry_jitter, instance_accessor: false, instance_predicate: false, default: 0.0
  class_attribute :after_discard_procs, default: []
end

Instance Method Details

#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