instance method attr_readonly

Ruby on Rails edge

Since v3.2.22.5

Available in: v3.2.22.5 v4.0.13 v4.1.16 v4.2.11.3 v5.0.7.2 v5.1.7 v5.2.8.1 v6.0.6.1 v6.1.7.10 v7.0.10 v7.1.6 v7.2.4 v8.0.5.1 v8.1.4 edge

Signature

attr_readonly(*attributes)

Attributes listed as readonly will be used to create a new record. Assigning a new value to a readonly attribute on a persisted record raises an error.

By setting config.active_record.raise_on_assign_to_attr_readonly to false, it will not raise. The value will change in memory, but will not be persisted on save.

Examples
class Post < ActiveRecord::Base
  attr_readonly :title
end

post = Post.create!(title: "Introducing Ruby on Rails!")
post.title = "a different title" # raises ActiveRecord::ReadonlyAttributeError
post.update(title: "a different title") # raises ActiveRecord::ReadonlyAttributeError

Parameters

attributes rest
Source
# File activerecord/lib/active_record/readonly_attributes.rb, line 32
      def attr_readonly(*attributes)
        attributes = attributes.map(&:to_s)
        self._attr_readonly = ActiveSupport::Ractors.make_shareable(_attr_readonly | attributes)

        # Pass the new attributes down to subclasses that hold their own copy.
        descendants.each do |subclass|
          next if subclass._attr_readonly.equal?(subclass.superclass._attr_readonly)

          subclass._attr_readonly = ActiveSupport::Ractors.make_shareable(subclass._attr_readonly | attributes)
        end

        if ActiveRecord._raise_on_assign_to_attr_readonly
          # The code generator changed, also for subclasses that already
          # generated their own writers.
          undefine_attribute_methods
          descendants.each(&:undefine_attribute_methods)
          include(HasReadonlyAttributes)
        end
      end

Defined in activerecord/lib/active_record/readonly_attributes.rb line 32 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveRecord::ReadonlyAttributes::ClassMethods

Type at least 2 characters to search.

Use the arrow keys to navigate results, Enter to open one, Escape to close.

Keyboard shortcuts

/
Focus search
⌘K / Ctrl-K
Command palette
?
This help
Esc
Close