Active Model 错误

传入使用错误对象的实例。

class Person
  def initialize
    @errors = ActiveModel::Errors.new(self)
  end
end

当传递一个符号或一个方法名称时，返回该方法的错误数组。

person.errors[:name]  # => ["cannot be nil"]
person.errors['name'] # => ["cannot be nil"]

在属性上添加一个新的类型错误。可以向同一个属性添加多个错误。如果没有提供类型，则假定为:invalid。

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"]}

如果类型是一个字符串，它将被用作错误消息。

如果类型是一个符号，它将使用适当的范围进行翻译（参见generate_message）。

person.errors.add(:name, :blank)
person.errors.messages
# => {:name=>["can't be blank"]}

person.errors.add(:name, :too_long, count: 25)
person.errors.messages
# => ["is too long (maximum is 25 characters)"]

如果类型是一个过程，它将被调用，允许在错误中使用诸如Time.now之类的东西。

如果:strict选项设置为true，它将引发ActiveModel::StrictValidationFailed而不是添加错误。:strict选项也可以设置为任何其他异常。

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 # => {}

如果错误与单个属性没有直接关联，则应将属性设置为:base。

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}]}

如果错误与提供的属性和类型匹配，则返回true，否则返回false。类型的处理方式与add相同。

person.errors.add :name, :blank
person.errors.added? :name, :blank           # => true
person.errors.added? :name, "can't be blank" # => true

如果错误需要选项，则它将返回带有正确选项的true，或返回带有不正确或缺失选项的false。

person.errors.add :name, :too_long, count: 25
person.errors.added? :name, :too_long, count: 25                     # => true
person.errors.added? :name, "is too long (maximum is 25 characters)" # => true
person.errors.added? :name, :too_long, count: 24                     # => false
person.errors.added? :name, :too_long                                # => false
person.errors.added? :name, "is too long"                            # => false

返回一个 Hash，可用作此对象的 JSON 表示。您可以传递 :full_messages 选项。这决定了 JSON 对象是否应包含完整消息（默认情况下为 false）。

person.errors.as_json                      # => {:name=>["cannot be nil"]}
person.errors.as_json(full_messages: true) # => {:name=>["name cannot be nil"]}

返回所有错误属性名称

person.errors.messages        # => {:name=>["cannot be nil", "must be specified"]}
person.errors.attribute_names # => [:name]

清除所有错误。但是，清除错误并不会使模型有效。下次运行验证时（例如，通过 ActiveRecord::Validations#valid?），如果任何验证失败，错误集合将再次填充。

删除 key 的消息。返回已删除的消息。

person.errors[:name]        # => ["cannot be nil"]
person.errors.delete(:name) # => ["cannot be nil"]
person.errors[:name]        # => []

返回一个 Hash，其中包含带有其错误详细信息数组的属性。

遍历每个错误对象。

person.errors.add(:name, :too_short, count: 2)
person.errors.each do |error|
  # Will yield <#ActiveModel::Error attribute=name, type=too_short,
                                    options={:count=>3}>
end

如果没有错误，则返回 true。

返回给定属性的完整消息。

person.errors.full_message(:name, 'is invalid') # => "Name is invalid"

以数组的形式返回所有完整错误消息。

class Person
  validates_presence_of :name, :address, :email
  validates_length_of :name, in: 5..30
end

person = Person.create(address: '123 First St.')
person.errors.full_messages
# => ["Name is too short (minimum is 5 characters)", "Name can't be blank", "Email can't be blank"]

以数组的形式返回给定属性的所有完整错误消息。

class Person
  validates_presence_of :name, :email
  validates_length_of :name, in: 5..30
end

person = Person.create()
person.errors.full_messages_for(:name)
# => ["Name is too short (minimum is 5 characters)", "Name can't be blank"]

在默认范围内（activemodel.errors.messages）翻译错误消息。

Error 消息首先在 activemodel.errors.models.MODEL.attributes.ATTRIBUTE.MESSAGE 中查找，如果不存在，则在 activemodel.errors.models.MODEL.MESSAGE 中查找，如果也不存在，则返回默认消息的翻译（例如 activemodel.errors.messages.MESSAGE）。已翻译的模型名称、已翻译的属性名称和值可用于插值。

在模型中使用继承时，它也会检查所有继承的模型，但前提是尚未找到模型本身。假设你有 class Admin < User; end，并且你想要 title 属性的 :blank 错误消息的翻译，它会查找以下翻译

• activemodel.errors.models.admin.attributes.title.blank

• activemodel.errors.models.admin.blank

• activemodel.errors.models.user.attributes.title.blank

• activemodel.errors.models.user.blank

• 通过 options 哈希（在 activemodel.errors 范围内）提供的任何默认值

• activemodel.errors.messages.blank

• errors.attributes.title.blank

• errors.messages.blank

返回一个 Hash，其中包含属性及其 Error 对象数组。

person.errors.group_by_attribute
# => {:name=>[<#ActiveModel::Error>, <#ActiveModel::Error>]}

导入一个错误。导入的错误将包装为 NestedError，提供对原始错误对象的访问。如果需要覆盖属性或类型，请使用 override_options。

选项

• :attribute - 覆盖错误所属的属性。

• :type - 覆盖错误的类型。

如果错误消息包含给定键 attribute 的错误，则返回 true，否则返回 false。

person.errors.messages        # => {:name=>["cannot be nil"]}
person.errors.include?(:name) # => true
person.errors.include?(:age)  # => false

合并来自 other 的错误，每个 Error 都包装为 NestedError。

参数

• other - ActiveModel::Errors 实例。

示例

person.errors.merge!(other)

返回一个 Hash，其中包含带有其错误消息数组的属性。

返回给定属性的所有错误消息，形式为数组。

class Person
  validates_presence_of :name, :email
  validates_length_of :name, in: 5..30
end

person = Person.create()
person.errors.messages_for(:name)
# => ["is too short (minimum is 5 characters)", "can't be blank"]

如果存在具有给定类型的属性上的错误，则返回 true，否则返回 false。type 的处理方式与 add 相同。

person.errors.add :age
person.errors.add :name, :too_long, count: 25
person.errors.of_kind? :age                                            # => true
person.errors.of_kind? :name                                           # => false
person.errors.of_kind? :name, :too_long                                # => true
person.errors.of_kind? :name, "is too long (maximum is 25 characters)" # => true
person.errors.of_kind? :name, :not_too_long                            # => false
person.errors.of_kind? :name, "is too long"                            # => false

返回错误数。

返回一个包含属性及其错误消息的 Hash。如果 full_messages 为 true，它将包含完整消息（请参阅 full_message）。

person.errors.to_hash       # => {:name=>["cannot be nil"]}
person.errors.to_hash(true) # => {:name=>["name cannot be nil"]}

搜索与 attribute、type 或 options 匹配的错误。

仅匹配提供的参数。

person.errors.where(:name) # => all name errors.
person.errors.where(:name, :too_short) # => all name errors being too short
person.errors.where(:name, :too_short, minimum: 2) # => all name errors being too short and minimum is 2