1 files changed, 27 insertions, 0 deletions
diff --git a/actionpack/lib/action_dispatch/testing/assertions/dom.rb b/actionpack/lib/action_dispatch/testing/assertions/dom.rb
new file mode 100644
index 0000000000..241a39393a
--- /dev/null
+++ b/actionpack/lib/action_dispatch/testing/assertions/dom.rb
@@ -0,0 +1,27 @@
+require 'action_view/vendor/html-scanner'
+
+module ActionDispatch
+  module Assertions
+    module DomAssertions
+      # \Test two HTML strings for equivalency (e.g., identical up to reordering of attributes)
+      #
+      #   # 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 = nil)
+        expected_dom = HTML::Document.new(expected).root
+        actual_dom   = HTML::Document.new(actual).root
+        assert_equal expected_dom, actual_dom, message
+      end
+
+      # The negated form of +assert_dom_equivalent+.
+      #
+      #   # 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 = nil)
+        expected_dom = HTML::Document.new(expected).root
+        actual_dom   = HTML::Document.new(actual).root
+        assert_not_equal expected_dom, actual_dom, message
+      end
+    end
+  end
+end