# module ActionDispatch::Assertions::DomAssertions

### Public Instance Methods

assert_dom_equal(expected, actual, message = "") click to toggle source

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")

    # File lib/action_dispatch/testing/assertions/dom.rb, line 13
    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

assert_dom_not_equal(expected, actual, message = "") click to toggle source

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")

    # File lib/action_dispatch/testing/assertions/dom.rb, line 28
    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