instance method
add
Ruby on Rails 6.1.7.10
Since v3.0.20Signature
add(attribute, type = :invalid, **options)
Adds a new error of type on attribute. More than one error can be added to the same attribute. If no type is supplied, :invalid is assumed.
person.errors.add(:name)
# Adds <#ActiveModel::Error attribute=name, type=invalid>
person.errors.add(:name, :not_implemented, message: "must be implemented")
# Adds <#ActiveModel::Error attribute=name, type=not_implemented,
options={:message=>"must be implemented"}>
person.errors.messages
# => {:name=>["is invalid", "must be implemented"]}
If type is a string, it will be used as error message.
If type is a symbol, it will be translated using the appropriate scope (see generate_message).
If type is a proc, it will be called, allowing for things like Time.now to be used within an error.
If the :strict option is set to true, it will raise ActiveModel::StrictValidationFailed instead of adding the error. :strict option can also be set to any other exception.
person.errors.add(:name, :invalid, strict: true)
# => ActiveModel::StrictValidationFailed: Name is invalid
person.errors.add(:name, :invalid, strict: NameIsInvalid)
# => NameIsInvalid: Name is invalid
person.errors.messages # => {}
attribute should be set to :base if the error is not directly associated with a single attribute.
person.errors.add(:base, :name_or_email_blank,
message: "either name or email must be present")
person.errors.messages
# => {:base=>["either name or email must be present"]}
person.errors.details
# => {:base=>[{error: :name_or_email_blank}]}
Parameters
-
attributereq -
typeopt = :invalid -
optionskeyrest
Source
# File activemodel/lib/active_model/errors.rb, line 404
def add(attribute, type = :invalid, **options)
attribute, type, options = normalize_arguments(attribute, type, **options)
error = Error.new(@base, attribute, type, **options)
if exception = options[:strict]
exception = ActiveModel::StrictValidationFailed if exception == true
raise exception, error.full_message
end
@errors.append(error)
error
end
Defined in activemodel/lib/active_model/errors.rb line 404
· View on GitHub
· Improve this page
· Find usages on GitHub
Defined in ActiveModel::Errors