# File activemodel/lib/active_model/errors.rb, line 203
def [](attribute)
  messages_for(attribute)
end

При передаче символа или имени метода возвращает массив ошибок для этого метода.

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

# File activemodel/lib/active_model/errors.rb, line 316
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

Добавляет новую ошибку типа type для attribute. К одному и тому же attribute можно добавить несколько ошибок. Если тип type не указан, используется :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"]}

Если type является строкой, она будет использована как сообщение об ошибке.

Если type является символом, он будет переведён с помощью соответствующего контекста (см. 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)"]

Если опция type установлена в 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 # => {}

attribute должно быть установлено в :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}]}

# File activemodel/lib/active_model/errors.rb, line 346
def added?(attribute, type = :invalid, options = {})
  attribute, type, options = normalize_arguments(attribute, type, **options)

  if type.is_a? Symbol
    @errors.any? { |error|
      error.strict_match?(attribute, type, **options)
    }
  else
    messages_for(attribute).include?(type)
  end
end

Возвращает true, если ошибка соответствует указанному attribute и type, или false в противном случае. type обрабатывается так же, как и для 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

# File activemodel/lib/active_model/errors.rb, line 221
def as_json(options = nil)
  to_hash(options && options[:full_messages])
end

Возвращает 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"]}

# File activemodel/lib/active_model/errors.rb, line 211
def attribute_names
  @errors.map(&:attribute).uniq.freeze
end

Возвращает все имена атрибутов ошибок

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

# File activemodel/lib/active_model/errors.rb, line 189
def delete(attribute, type = nil, **options)
  attribute, type, options = normalize_arguments(attribute, type, **options)
  matches = where(attribute, type, **options)
  matches.each do |error|
    @errors.delete(error)
  end
  matches.map(&:message).presence
end

Удаляет сообщения об ошибках для key. Возвращает удалённые сообщения.

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

# File activemodel/lib/active_model/errors.rb, line 250
def details
  hash = group_by_attribute.transform_values do |errors|
    errors.map(&:details)
  end
  hash.default = EMPTY_ARRAY
  hash.freeze
  hash
end

Возвращает Hash атрибутов с массивом деталей об ошибках.

# File activemodel/lib/active_model/errors.rb, line 425
def full_message(attribute, message)
  Error.full_message(attribute, message, @base)
end

Возвращает полное сообщение для заданного атрибута.

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

# File activemodel/lib/active_model/errors.rb, line 389
def full_messages
  @errors.map(&:full_message)
end

Возвращает все полные сообщения об ошибках в массиве.

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

# File activemodel/lib/active_model/errors.rb, line 404
def full_messages_for(attribute)
  where(attribute).map(&:full_message).freeze
end

Возвращает все полные сообщения об ошибках для данного атрибута в массиве.

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

# File activemodel/lib/active_model/errors.rb, line 453
def generate_message(attribute, type = :invalid, options = {})
  Error.generate_message(attribute, type, @base, options)
end

Переводит сообщение об ошибке в его стандартном контексте (activemodel.errors.messages).

Error сообщения сначала ищутся в activemodel.errors.models.MODEL.attributes.ATTRIBUTE.MESSAGE, если их нет, то в activemodel.errors.models.MODEL.MESSAGE, и если их нет, возвращает перевод стандартного сообщения (например, activemodel.errors.messages.MESSAGE). Переведённое имя модели, переведённое имя атрибута и значение доступны для интерполяции.

При использовании наследования в ваших моделях, оно будет проверять все унаследованные модели, но только если сама модель не найдена. Предположим, у вас есть class Admin < User; end, и вы хотите получить перевод для ошибки :blank для атрибута title. Оно ищет эти переводы:

• 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

# File activemodel/lib/active_model/errors.rb, line 263
def group_by_attribute
  @errors.group_by(&:attribute)
end

Возвращает Hash атрибутов с массивом их Error объектов.

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

# File activemodel/lib/active_model/errors.rb, line 128
def import(error, override_options = {})
  [:attribute, :type].each do |key|
    if override_options.key?(key)
      override_options[key] = override_options[key].to_sym
    end
  end
  @errors.append(NestedError.new(@base, error, override_options))
end

Импортирует одну ошибку. Импортированные ошибки оборачиваются как NestedError, предоставляя доступ к исходному объекту ошибки. Если атрибут или тип нужно переопределить, используйте override_options.

Параметры

• :attribute - Переопределить атрибут, к которому относится ошибка.

• :type - Переопределить тип ошибки.

# File activemodel/lib/active_model/errors.rb, line 176
def include?(attribute)
  @errors.any? { |error|
    error.match?(attribute.to_sym)
  }
end

Возвращает true, если сообщения об ошибках содержат ошибку для данного ключа attribute, false в противном случае.

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

# File activemodel/lib/active_model/errors.rb, line 148
def merge!(other)
  return errors if equal?(other)

  other.errors.each { |error|
    import(error)
  }
end

Объединяет ошибки из other, каждая Error обернута как NestedError.

Параметры

• other - Экземпляр ActiveModel::Errors.

Примеры

person.errors.merge!(other)

# File activemodel/lib/active_model/errors.rb, line 242
def messages
  hash = to_hash
  hash.default = EMPTY_ARRAY
  hash.freeze
  hash
end

Возвращает Hash атрибутов с массивом их сообщений об ошибках.

# File activemodel/lib/active_model/errors.rb, line 418
def messages_for(attribute)
  where(attribute).map(&:message)
end

Возвращает все сообщения об ошибках для заданного атрибута в виде массива.

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

# File activemodel/lib/active_model/errors.rb, line 369
def of_kind?(attribute, type = :invalid)
  attribute, type = normalize_arguments(attribute, type)

  if type.is_a? Symbol
    !where(attribute, type).empty?
  else
    messages_for(attribute).include?(type)
  end
end

Возвращает 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

# File activemodel/lib/active_model/errors.rb, line 230
def to_hash(full_messages = false)
  message_method = full_messages ? :full_message : :message
  group_by_attribute.transform_values do |errors|
    errors.map(&message_method)
  end
end

Возвращает Hash атрибутов с их сообщениями об ошибках. Если full_messages равно true, оно будет содержать полные сообщения (см. full_message).

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

# File activemodel/lib/active_model/errors.rb, line 163
def where(attribute, type = nil, **options)
  attribute, type, options = normalize_arguments(attribute, type, **options)
  @errors.select { |error|
    error.match?(attribute, type, **options)
  }
end

Поиск ошибок, соответствующих 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