модуль ActionController::Head

Открытые методы экземпляра

head (status, options = nil) Показать исходный код

# File actionpack/lib/action_controller/metal/head.rb, line 23
def head(status, options = nil)
  if status.is_a?(Hash)
    raise ArgumentError, "#{status.inspect} is not a valid value for `status`."
  end

  raise ::AbstractController::DoubleRenderError if response_body

  status ||= :ok

  if options
    location = options.delete(:location)
    content_type = options.delete(:content_type)

    options.each do |key, value|
      headers[key.to_s.split(/[-_]/).each { |v| v[0] = v[0].upcase }.join("-")] = value.to_s
    end
  end

  self.status = status
  self.location = url_for(location) if location

  if include_content?(response_code)
    unless self.media_type
      self.content_type = content_type || ((f = formats) && Mime[f.first]) || :html
    end

    response.charset = false
  end

  self.response_body = ""

  true
end

Возвращает ответ без содержимого (только заголовки). Аргумент options интерпретируется как хеш имен заголовков и их значений. Это позволяет легко вернуть ответ, состоящий только из важных заголовков:

head :created, location: person_path(@person)

head :created, location: @person

Его также можно использовать для возврата исключительных условий:

return head(:method_not_allowed) unless request.post?
return head(:bad_request) unless valid_request?
render

Полный список допустимых символов status см. в Rack::Utils::SYMBOL_TO_STATUS_CODE.