`, etc).
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_attr_content: ['button']})`
**Example:** With `ignore_attr_content: ['button']` the following HTML strings are considered equal:
Link
Link
**Example:** With `ignore_attr_content: ['menu']` the following HTML strings are considered equal:
Link
----------
-
`ignore_attrs: [css_selector1, css_selector1, ...]` default: **`[]`**
When provided, ignores all **attributes** that satisfy a particular rule using [CSS selectors](http://www.w3schools.com/cssref/css_selectors.asp).
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_attrs: ['a[rel="nofollow"]', 'input[type="hidden"']})`
**Example:** With `ignore_attrs: ['a[rel="nofollow"]', 'a[target]']` the following HTML strings are considered equal:
Link
Link
**Example:** With `ignore_attrs: ['a[href^="http"]', 'a[class*="button"]']` the following HTML strings are considered equal:
Link
Link
----------
-
`ignore_attrs_by_name: [string1, string2, ...]` default: **`false`**
When provided, ignores all **attributes** which name is specified in the string array.
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_attrs_by_name: ['target'])`
**Example:** With `ignore_attrs_by_name: ['target', 'rel']` the following HTML strings are considered equal:
Link
Link
----------
- `ignore_comments: {true|false}` default: **`true`**
When `true`, ignores comments, such as ``.
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_comments: true})`
**Example:** When `true` the following HTML strings are considered equal:
**Example:** When `true` the following HTML strings are considered equal:
Link
Link
----------
-
`ignore_nodes: [css_selector1, css_selector1, ...]` default: **`[]`**
When provided, ignores all **nodes** that satisfy a particular rule using [CSS selectors](http://www.w3schools.com/cssref/css_selectors.asp).
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_nodes: ['script', 'object']})`
**Example:** With `ignore_nodes: ['a[rel="nofollow"]', 'a[target]']` the following HTML strings are considered equal:
Link 1
Link 2
**Example:** With `ignore_nodes: ['b', 'i']` the following HTML strings are considered equal:
Warning: Link
Message: Link
----------
-
`ignore_text_nodes: {true|false}` default: **`false`**
When `true`, ignores all text content. Text content is anything that is included between an opening and a closing tag, e.g. `
THIS IS TEXT CONTENT`.
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_text_nodes: true})`
**Example:** When `true` the following HTML strings are considered equal:
SOME TEXT CONTENT
DIFFERENT TEXT CONTENT
**Example:** When `true` the following HTML strings are considered equal:
Message:
----------
-
`verbose: {true|false}` default: **`false`**
When `true`, instead of returning a boolean value `CompareXML.equivalent?` returns an array of all errors encountered when performing a comparison.
> **Warning:** When `true`, the comparison takes longer! Not only because more processing is required to produce meaningful differences, but also because in this mode, comparison does **NOT** stop when a first difference is encountered, because the goal is to capture as many differences as possible.
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {verbose: true})`
**Example:** When `true` given the following HTML strings:
`CompareXML.equivalent?(doc1, doc2, {verbose: true})` will produce an array shown below.
```ruby
[
{
node1: '
TITLE',
node2: '
ANOTHER TITLE',
diff1: 'TITLE',
diff2: 'ANOTHER TITLE',
},
{
node1: '
SOME HEADING
',
node2: '
SOME HEADING
',
diff1: nil,
diff2: 'id="main"',
},
{
node1: '
Link',
node2: '
Link',
diff1: '"rel="icon"',
diff2: '"rel="button"',
},
{
node1: '
Author Name',
node2: nil,
diff1: '
Author Name',
diff2: nil,
},
{
node1: '',
node2: '',
diff1: 'p',
diff2: 'div',
}
]
```
The structure of each hash inside the array is:
node1: [Nokogiri::XML::Node] left node that contains the difference
node2: [Nokogiri::XML::Node] right node that contains the difference
diff1: [Nokogiri::XML::Node|String] left difference
diff2: [Nokogiri::XML::Node|String] right difference
----------
-
`ignore_children: {true|false}` default: **`false`**
When provided, ignores all **subnodes** of any node.
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_children: true})`
**Example:** With `ignore_children: true` the following HTML strings are considered equal:
Link 1
Link 2
----------
-
`force_children: {true|false}` default: **`false`**
When provided, compares all **subnodes** of any node.
**Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_children: true})`
----------
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
## Credits
This gem was inspired by [Michael B. Klein](https://github.com/mbklein)'s gem [`equivalent-xml`](https://github.com/mbklein/equivalent-xml) - another excellent tool for XML comparison.
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).