Осуществляет проверку двух узлов на равенство (не на идентичность). Два узла HTML равны, если: узлы являются узлами одного типа; значения следующих свойств узла равны: ИмяУзла, ЛокальноеИмя, Префикс и ЗначениеУзла (или оба значения свойство не определены, или оба равны); коллекции атрибутов узлов равны: или обе не определены, или имеют одинаковый размер и одинаковое значение для одинаковых ключей (необязательно при этом с одинаковыми индексами); списки дочерних узлов равны: или оба списка пустые, или оба имеют одинаковую длину и содержат равные узлы по одинаковым индексам. Нормализация влияет на равенство. Чтобы избежать ошибок сравнения, рекомендуется нормализовать узлы перед сравнением. Два узла ОпределениеТипаДокумента равны, если выполняются все вышеперечисленные условия, а также: значения следующих свойств равны: ПубличныйИдентификатор, СистемныйИдентификатор, ВнутреннееПодмножество; коллекции определений сущностей равны; коллекции нотаций равны. На равенство не оказывают влияние: свойства ДокументВладелец, БазовыйURI и РодительУзла; свойство Указан для узлов Атрибут; свойство ЭтоПробельныеСимволыЭлемента для узлов Текст; пользовательские данные. Замечание. Все, что не указано как влияющее на равенство, на него не влияет.
Синтаксис
УзелРавен(<Узел>)Полное описание, параметры и ограничения
ЭлементФреймHTML.УзелРавен (HTMLFrameElement.IsEqualNode)
ЭлементФреймHTML (HTMLFrameElement)
УзелРавен (IsEqualNode)
Доступен, начиная с версии 8.2.
Синтаксис:
УзелРавен(<Узел>)
Параметры:
<Узел> (обязательный)
Тип: АтрибутHTML, ЭлементHTML, ЭлементКнопкаHTML, ЭлементВводаHTML, ЭлементЗаголовокHTML, ЭлементРазметкаHTML, ЭлементПлавающийФреймHTML, ЭлементВставкаHTML, ЭлементФреймHTML, ЭлементНаборФреймовHTML, ЭлементМетаHTML, ЭлементОбъектHTML, ЭлементСкриптHTML, ЭлементТаблицаHTML, ЭлементСтрокаТаблицыHTML, ЭлементЯчейкаТаблицыHTML, ЭлементКолонкаТаблицыHTML, ЭлементЗаголовокТаблицыHTML, ЭлементБлокHTML, ЭлементЛинияHTML, ЭлементФорматированногоТекстаHTML, ЭлементКартинкаHTML, ЭлементСвязьHTML, ЭлементЯкорьHTML, ЭлементАплетHTML, ЭлементФормаHTML, ДокументHTML, ТекстHTML, КомментарийHTML.
Сравниваемый узел HTMLDOM.
Возвращаемое значение:
Тип: Булево.
Описание:
Осуществляет проверку двух узлов на равенство (не на идентичность).
Два узла HTML равны, если:
узлы являются узлами одного типа;
значения следующих свойств узла равны: ИмяУзла, ЛокальноеИмя, Префикс и ЗначениеУзла (или оба значения свойство не определены, или оба равны);
коллекции атрибутов узлов равны: или обе не определены, или имеют одинаковый размер и одинаковое значение для одинаковых ключей (необязательно при этом с одинаковыми индексами);
списки дочерних узлов равны: или оба списка пустые, или оба имеют одинаковую длину и содержат равные узлы по одинаковым индексам.
Нормализация влияет на равенство. Чтобы избежать ошибок сравнения, рекомендуется нормализовать узлы перед сравнением.
Два узла ОпределениеТипаДокумента равны, если выполняются все вышеперечисленные условия, а также:
значения следующих свойств равны: ПубличныйИдентификатор, СистемныйИдентификатор, ВнутреннееПодмножество;
коллекции определений сущностей равны;
коллекции нотаций равны.
На равенство не оказывают влияние:
свойства ДокументВладелец, БазовыйURI и РодительУзла;
свойство Указан для узлов Атрибут;
свойство ЭтоПробельныеСимволыЭлемента для узлов Текст;
пользовательские данные.
Замечание. Все, что не указано как влияющее на равенство, на него не влияет.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Создать и клонировать 25 видов элементов без запуска ресурсов
Создаём отдельные пустые узлы фабрикой собственного документа: от поля до старого applet. Клонирование делает другое дерево, а не загружает ресурс.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.
Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.
Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.
Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
Ожидаемые = Новый Соответствие;
Ожидаемые.Вставить("guide-section", "ЭлементHTML");
Ожидаемые.Вставить("div", "ЭлементБлокHTML");
Ожидаемые.Вставить("pre", "ЭлементФорматированногоТекстаHTML");
Ожидаемые.Вставить("form", "ЭлементФормаHTML");
Ожидаемые.Вставить("input", "ЭлементВводаHTML");
Ожидаемые.Вставить("button", "ЭлементКнопкаHTML");
Ожидаемые.Вставить("table", "ЭлементТаблицаHTML");
Ожидаемые.Вставить("tr", "ЭлементСтрокаТаблицыHTML");
Ожидаемые.Вставить("td", "ЭлементЯчейкаТаблицыHTML");
Ожидаемые.Вставить("col", "ЭлементКолонкаТаблицыHTML");
Ожидаемые.Вставить("caption", "ЭлементЗаголовокТаблицыHTML");
Ожидаемые.Вставить("a", "ЭлементЯкорьHTML");
Ожидаемые.Вставить("img", "ЭлементКартинкаHTML");
Ожидаемые.Вставить("meta", "ЭлементМетаHTML");
Ожидаемые.Вставить("link", "ЭлементСвязьHTML");
Ожидаемые.Вставить("head", "ЭлементЗаголовокHTML");
Ожидаемые.Вставить("html", "ЭлементРазметкаHTML");
Ожидаемые.Вставить("hr", "ЭлементЛинияHTML");
Ожидаемые.Вставить("script", "ЭлементСкриптHTML");
Ожидаемые.Вставить("iframe", "ЭлементПлавающийФреймHTML");
Ожидаемые.Вставить("frame", "ЭлементФреймHTML");
Ожидаемые.Вставить("frameset", "ЭлементНаборФреймовHTML");
Ожидаемые.Вставить("embed", "ЭлементВставкаHTML");
Ожидаемые.Вставить("object", "ЭлементОбъектHTML");
Ожидаемые.Вставить("applet", "ЭлементАплетHTML");
Для Каждого Пара Из Ожидаемые Цикл
Узел = Документ.СоздатьЭлемент(Пара.Ключ);
Если ТипЗнч(Узел) <> Тип(Пара.Значение) Тогда
ВызватьИсключение "Фактический тип фабрики отличается для " + Пара.Ключ;
КонецЕсли;
Копия = Узел.КлонироватьУзел(Истина);
Сообщить(Пара.Ключ + ": " + Строка(Узел.УзелРавен(Копия)));
Сообщить(Не Узел.УзелИдентичен(Копия));
Сообщить(Копия.ДокументВладелец = Документ);
Сообщить(Копия.РодительскийУзел = Неопределено);
КонецЦикла;
Сообщить(Документ.Формы.Количество() = 1);Разбор по шагам
Соответствие задаёт тег и ожидаемый специальный тип; несоответствие останавливает упражнение.
Элементы остаются отсоединёнными: не задаём src, href, код или данные объекта, не передаём дерево браузеру.
УзелРавен сравнивает структуру; УзелИдентичен отличает исходный объект от копии.
У копии владелец тот же, но родителя нет; собственная форма заказа не удваивается.
Как проверить результат
Для каждого из 25 тегов равенство Истина, неидентичность Истина и две проверки владельца/родителя Истина.
В исходном документе по-прежнему одна форма; script, frame и applet из цикла туда не вставляются.
Ожидаемый результат
Показан реальный общий интерфейс конкретных типов HTML-узлов.
На что обратить внимание
Старые frame, applet и embed нужны для чтения старых документов, не как рекомендация создавать новый интерфейс.
Создание DOM-узла не запускает Java, JavaScript и загрузку сайта; отображление внешней разметки — отдельное действие.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сохранить учебное состояние рядом с узлом, не внутри HTML
Пользовательские данные хранят число проверок 3. Они не становятся атрибутом и не копируются как часть структуры узла.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.
Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.
Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.
Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
Ожидаемые = Новый Соответствие;
Ожидаемые.Вставить("guide-section", "ЭлементHTML");
Ожидаемые.Вставить("div", "ЭлементБлокHTML");
Ожидаемые.Вставить("pre", "ЭлементФорматированногоТекстаHTML");
Ожидаемые.Вставить("form", "ЭлементФормаHTML");
Ожидаемые.Вставить("input", "ЭлементВводаHTML");
Ожидаемые.Вставить("button", "ЭлементКнопкаHTML");
Ожидаемые.Вставить("table", "ЭлементТаблицаHTML");
Ожидаемые.Вставить("tr", "ЭлементСтрокаТаблицыHTML");
Ожидаемые.Вставить("td", "ЭлементЯчейкаТаблицыHTML");
Ожидаемые.Вставить("col", "ЭлементКолонкаТаблицыHTML");
Ожидаемые.Вставить("caption", "ЭлементЗаголовокТаблицыHTML");
Ожидаемые.Вставить("a", "ЭлементЯкорьHTML");
Ожидаемые.Вставить("img", "ЭлементКартинкаHTML");
Ожидаемые.Вставить("meta", "ЭлементМетаHTML");
Ожидаемые.Вставить("link", "ЭлементСвязьHTML");
Ожидаемые.Вставить("head", "ЭлементЗаголовокHTML");
Ожидаемые.Вставить("html", "ЭлементРазметкаHTML");
Ожидаемые.Вставить("hr", "ЭлементЛинияHTML");
Ожидаемые.Вставить("script", "ЭлементСкриптHTML");
Ожидаемые.Вставить("iframe", "ЭлементПлавающийФреймHTML");
Ожидаемые.Вставить("frame", "ЭлементФреймHTML");
Ожидаемые.Вставить("frameset", "ЭлементНаборФреймовHTML");
Ожидаемые.Вставить("embed", "ЭлементВставкаHTML");
Ожидаемые.Вставить("object", "ЭлементОбъектHTML");
Ожидаемые.Вставить("applet", "ЭлементАплетHTML");
Для Каждого Пара Из Ожидаемые Цикл
Узел = Документ.СоздатьЭлемент(Пара.Ключ);
Если ТипЗнч(Узел) <> Тип(Пара.Значение) Тогда
ВызватьИсключение "Фактический тип фабрики отличается для " + Пара.Ключ;
КонецЕсли;
Узел.УстановитьПользовательскиеДанные("guide-checks", 3);
Сообщить(Узел.ПолучитьПользовательскиеДанные("guide-checks") = 3);
Сообщить(Не Узел.ЕстьАтрибут("guide-checks"));
Копия = Узел.КлонироватьУзел(Истина);
Сообщить(Копия.ПолучитьПользовательскиеДанные("guide-checks") = Неопределено);
Сообщить(Узел.УзелРавен(Копия));
КонецЦикла;Разбор по шагам
Служебное число записываем отдельным механизмом пользовательских данных.
Проверяем, что одноимённый HTML-атрибут не создан.
Копия структурно равна оригиналу, но не содержит его служебной пометки.
Как проверить результат
Четыре сравнения для каждого элемента Истина: число 3, отсутствие атрибута и данных у копии, равенство структуры.
Узел не стал ссылкой на объект базы, а число не записано в информационную базу.
Ожидаемый результат
Разделены временное состояние программы и сериализуемая структура HTML.
На что обратить внимание
Не используйте эти данные как постоянное хранилище настроек.
Не рассчитывайте на их перенос при клонировании или импорте.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.