Sha256: a6e71b8b3b79136d25f75f57d1fce79bc71c1a4b6059bc29c51468d6dfc33a1e

Contents?: true

Size: 1.73 KB

Versions: 24

Compression:

Stored size: 1.73 KB

Contents

# frozen_string_literal: true

# :markup: markdown

module ActionController
  module Head
    # Returns a response that has no content (merely headers). The options argument
    # is interpreted to be a hash of header names and values. This allows you to
    # easily return a response that consists only of significant headers:
    #
    #     head :created, location: person_path(@person)
    #
    #     head :created, location: @person
    #
    # It can also be used to return exceptional conditions:
    #
    #     return head(:method_not_allowed) unless request.post?
    #     return head(:bad_request) unless valid_request?
    #     render
    #
    # See `Rack::Utils::SYMBOL_TO_STATUS_CODE` for a full list of valid `status`
    # symbols.
    def head(status, options = nil)
      if status.is_a?(Hash)
        raise ArgumentError, "#{status.inspect} is not a valid value for `status`."
      end

      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]) || Mime[:html]
        end

        response.charset = false
      end

      self.response_body = ""

      true
    end

    private
      def include_content?(status)
        case status
        when 100..199
          false
        when 204, 205, 304
          false
        else
          true
        end
      end
  end
end

Version data entries

24 entries across 24 versions & 2 rubygems

Version Path
actionpack-8.0.2 lib/action_controller/metal/head.rb
actionpack-8.0.1 lib/action_controller/metal/head.rb
actionpack-8.0.0.1 lib/action_controller/metal/head.rb
actionpack-7.2.2.1 lib/action_controller/metal/head.rb
actionpack-8.0.0 lib/action_controller/metal/head.rb
actionpack-7.2.2 lib/action_controller/metal/head.rb
actionpack-8.0.0.rc2 lib/action_controller/metal/head.rb
actionpack-7.2.1.2 lib/action_controller/metal/head.rb
actionpack-8.0.0.rc1 lib/action_controller/metal/head.rb
actionpack-7.2.1.1 lib/action_controller/metal/head.rb
actionpack-8.0.0.beta1 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha9 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha8 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha7 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha4 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha3 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha2 lib/action_controller/metal/head.rb
omg-actionpack-8.0.0.alpha1 lib/action_controller/metal/head.rb
actionpack-7.2.1 lib/action_controller/metal/head.rb
actionpack-7.2.0 lib/action_controller/metal/head.rb