Contents

=begin
    Copyright 2010-2014 Tasos Laskos <[e-mail]>

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

        http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
=end

module Arachni::Element
module Capabilities::Refreshable

    #
    # Refreshes the form's inputs and re-applies user updates.
    #
    # The way it works is by requesting the {Element::Base#url}, parsing the response
    # and updating the form with the fresh form's inputs.
    #
    # @param    [Hash]   http_opts   HTTP options to pass to the request
    # @param    [Block]  block       if a block is given the request will be async
    #                                    and the block will be called with the
    #                                    updated form.
    #
    # @return   [Form]  self
    #
    def refresh( http_opts = {}, &block )
        updated = nil
        http.get( url.to_s, http_opts.merge( async: !!block ) ) do |res|
            # find ourselves
            f = self.class.from_response( res ).select { |f| f.id == id_from( :original ) }.first

            if !f
                block.call if block_given?
                next
            end

            # get user updates
            updates = changes
            # update the form's inputs with the fresh ones and re-apply the user changes
            updated = update( f.auditable ).update( updates )
            block.call( updated ) if block_given?
        end
        updated
    end

end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
arachni-0.4.7	lib/arachni/element/capabilities/refreshable.rb
arachni-0.4.6	lib/arachni/element/capabilities/refreshable.rb