Sha256: 7e80335e9f81a21678e43399357a8d86e78726a1b37f537cfc79a562c9af87ea

Contents?: true

Size: 1.71 KB

Versions: 8

Compression:

Stored size: 1.71 KB

Contents

class Roda
  module RodaPlugins
    # The head plugin attempts to automatically handle HEAD requests,
    # by treating them as GET requests and returning an empty body
    # without modifying the response status or response headers.
    #
    # So for the following routes,
    #
    #   route do |r|
    #     r.root do
    #       'root'
    #     end
    #
    #     r.get 'a' do
    #       'a'
    #     end
    #
    #     r.is 'b', :method=>[:get, :post] do
    #       'b'
    #     end
    #   end
    #
    # HEAD requests for +/+, +/a+, and +/b+ will all return 200 status
    # with an empty body.
    #
    # NOTE: if you have a public facing website it is recommended that
    # you enable this plugin. Search engines and other bots may send a
    # HEAD request prior to crawling a page with a GET request. Without
    # this plugin those HEAD requests will return a 404 status, which
    # may prevent search engine's from crawling your website.
    module Head
      EMPTY_ARRAY = [].freeze

      module InstanceMethods
        # Always use an empty response body for head requests, with a
        # content length of 0.
        def call(*)
          res = super
          if @_request.head?
            res[2] = EMPTY_ARRAY
          end
          res
        end
      end

      module RequestMethods
        # Consider HEAD requests as GET requests.
        def is_get?
          super || head?
        end

        private

        # If the current request is a HEAD request, match if one of
        # the given methods is a GET request.
        def match_method(method)
          super || (!method.is_a?(Array) && head? && method.to_s.upcase == 'GET')
        end
      end
    end

    register_plugin(:head, Head)
  end
end

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
roda-2.9.0 lib/roda/plugins/head.rb
roda-2.8.0 lib/roda/plugins/head.rb
roda-2.7.0 lib/roda/plugins/head.rb
roda-2.6.0 lib/roda/plugins/head.rb
roda-2.5.1 lib/roda/plugins/head.rb
roda-2.5.0 lib/roda/plugins/head.rb
roda-2.4.0 lib/roda/plugins/head.rb
roda-2.3.0 lib/roda/plugins/head.rb