aboutsummaryrefslogblamecommitdiffstats
path: root/actionpack/lib/action_dispatch/testing/assertions/dom.rb
blob: 9c215de743a27e914cc360ea9114cfd15af65964 (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11
12

                                               
                     

                        
                                                                                              





                                                                                                                     
                                                          


                                                                                                                   
 
                                                                 
         
 
                                                    





                                                                                                                          
                                                              


                                                                                                                   
 
                                                                 


         
   
require 'action_controller/vendor/html-scanner'

module ActionDispatch
  module Assertions
    module DomAssertions
      # Test two HTML strings for equivalency (e.g., identical up to reordering of attributes)
      #
      # ==== Examples
      #
      #   # assert that the referenced method generates the appropriate HTML string
      #   assert_dom_equal '<a href="http://www.example.com">Apples</a>', link_to("Apples", "http://www.example.com")
      #
      def assert_dom_equal(expected, actual, message = "")
        expected_dom = HTML::Document.new(expected).root
        actual_dom   = HTML::Document.new(actual).root
        full_message = build_message(message, "<?> expected to be == to\n<?>.", expected_dom.to_s, actual_dom.to_s)

        assert_block(full_message) { expected_dom == actual_dom }
      end

      # The negated form of +assert_dom_equivalent+.
      #
      # ==== Examples
      #
      #   # assert that the referenced method does not generate the specified HTML string
      #   assert_dom_not_equal '<a href="http://www.example.com">Apples</a>', link_to("Oranges", "http://www.example.com")
      #
      def assert_dom_not_equal(expected, actual, message = "")
        expected_dom = HTML::Document.new(expected).root
        actual_dom   = HTML::Document.new(actual).root
        full_message = build_message(message, "<?> expected to be != to\n<?>.", expected_dom.to_s, actual_dom.to_s)

        assert_block(full_message) { expected_dom != actual_dom }
      end
    end
  end
end