Из списка одинаковых атрибутов тэга, для сравнения будет взят тот, который идет первым, остальные будут проигнорированы (по умолчанию: `false`). **Пример**: `true`
Следующие два HTML будут считаться эквивалентными: ```html Text ``` ```html Text ``` #### Пресеты * [bem](https://github.com/bem/html-differ/blob/master/presets/bem.json) - уставливает предопределенные опции для [БЭМ](http://ru.bem.info/). ##### Использование Передача пресета конструктору: ```js var HtmlDiffer = require('html-differ').HtmlDiffer, htmlDiffer = new HtmlDiffer('bem'); ``` Переопределение пресета через конструктор: ```js var HtmlDiffer = require('html-differ').HtmlDiffer, htmlDiffer = new HtmlDiffer({ preset: 'bem', ignoreAttributes: [] }); ``` #### Методы ##### htmlDiffer.diffHtml **@param** *{String}* - 1-й HTML
**@param** *{String}* - 2-й HTML
**@returns** *{Array of objects}* - [массив с отличиями](https://github.com/kpdecker/jsdiff#change-objects) между HTML ##### htmlDiffer.isEqual **@param** *{String}* - 1-й HTML
**@param** *{String}* - 2-й HTML
**@returns** *{Boolean}* ### Logger ```js var logger = require('html-differ/lib/logger'); ``` #### Методы ##### logger.getDiffText **@param** *{Array of objects}* - результат работы метода [htmlDiffer.diffHtml](https://github.com/bem/html-differ/blob/master/README.ru.md#htmldifferdiffhtml)
**@param** *{Object}* - опции:
* **charsAroundDiff: Number** - количество символов перед отличием между HTML и после него (по умолчанию: `40`) **@returns** *{String}* ##### logger.logDiffText **@param** *{Array of objects}* - результат работы метода [htmlDiffer.diffHtml](https://github.com/bem/html-differ/blob/master/README.ru.md#htmldifferdiffhtml)
**@param** *{Object}* - опции:
* **charsAroundDiff: Number** - количество символов перед отличием между HTML и после него (по умолчанию: `40`) **@returns** - вывод отличий:
### Пример
```js
var fs = require('fs'),
HtmlDiffer = require('html-differ').HtmlDiffer,
logger = require('html-differ/lib/logger');
var html1 = fs.readFileSync('1.html', 'utf-8'),
html2 = fs.readFileSync('2.html', 'utf-8');
var options = {
ignoreAttributes: [],
compareAttributesAsJSON: [],
ignoreWhitespaces: true,
ignoreComments: true,
ignoreEndTags: false,
ignoreDuplicateAttributes: false
};
var htmlDiffer = new HtmlDiffer(options);
var diff = htmlDiffer.diffHtml(html1, html2),
isEqual = htmlDiffer.isEqual(html1, html2),
res = logger.getDiffText(diff, { charsAroundDiff: 40 });
logger.logDiffText(diff, { charsAroundDiff: 40 });
```
## Использование в качестве программы
```bash
$ html-differ --help
Сравнивает два HTML
Использование:
html-differ [ОПЦИИ] [АРГУМЕНТЫ]
Опции:
-h, --help : Помощь
-v, --version : Показывает номер версии
--config=CONFIG : Путь к конфигурационному JSON-файлу
--bem : Использует предопределенные опции для БЭМ (устаревшая опция)
-p PRESET, --preset=PRESET : Имя пресета
--chars-around-diff=CHARSAROUNDDIFF : Количество символов перед отличием и после него (по умолчанию: 40)
Аргументы:
PATH1 : Путь к 1-ому HTML-файлу (обязательный аргумент)
PATH2 : Путь ко 2-ому HTML-файлу (обязательный аргумент)
```
### Пример
```bash
$ html-differ путь/к/html1 путь/к/html2
$ html-differ --config=путь/к/конфигу --chars-around-diff=40 путь/к/html1 путь/к/html2
$ html-differ --preset=bem путь/к/html1 путь/к/html2
```
### Конфигурационный файл
Рассмотрите следующий файл `config.json`:
```js
{
"ignoreAttributes": [],
"compareAttributesAsJSON": [],
"ignoreWhitespaces": true,
"ignoreComments": true,
"ignoreEndTags": false,
"ignoreDuplicateAttributes": false
}
```
## Маски
**html-differ** поддерживает использование _масок_ в HTML.
Например, следующие два HTML будут считаться эквивалентными:
```html
```
```html
```
### Синтаксис
Для записи _масок_ в **html-differ** используется следующий синтаксис:
```js
{{RegExp}}
```
где:
* `{{` – открывающий идентификатор _маски_.
* `RegExp` – регулярное выражение для сопоставления с соответствующим значением в сравниваемом HTML. Имеет такой же синтаксис как и регулярные выражения в JavaScript, записанные в _literal notation_.
* `}}` – закрывающий идентификатор _маски_.
### Экранирование
Правила экранирования символов такие же как и при использовании регулярных выражений в JavaScript, записанных в _literal notation_.
Например, следующие два HTML будут считаться эквивалентными:
```html
```
```html
```
Если вы хотите хотите использовать `{{` или `}}` внутри маски, вам необходимо экранировать обе фигурные скобки, то есть `\{\}` или `\}\}`
Например, следующие два HTML будут считаться эквивалентными:
```html
```
```html
```