Прикрепить служебную отметку к узлу отдельно от HTML-атрибута

Собственная временная отметка обработки не должна подменять данные заказа или видимый атрибут HTML.

Подготовка

1. Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.

2. Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.

3. Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.

4. Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.

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-документ";
КонецЕсли;
ОжидаемыеУзлы = Новый Соответствие;
ОжидаемыеУзлы.Вставить("order", "ЭлементФормаHTML");
ОжидаемыеУзлы.Вставить("customer", "ЭлементВводаHTML");
ОжидаемыеУзлы.Вставить("preview", "ЭлементКнопкаHTML");
ОжидаемыеУзлы.Вставить("items", "ЭлементТаблицаHTML");
ОжидаемыеУзлы.Вставить("book", "ЭлементСтрокаТаблицыHTML");
ОжидаемыеУзлы.Вставить("book-name", "ЭлементЯчейкаТаблицыHTML");
ОжидаемыеУзлы.Вставить("caption", "ЭлементЗаголовокТаблицыHTML");
ОжидаемыеУзлы.Вставить("column", "ЭлементКолонкаТаблицыHTML");
ОжидаемыеУзлы.Вставить("help", "ЭлементЯкорьHTML");
ОжидаемыеУзлы.Вставить("logo", "ЭлементКартинкаHTML");
ОжидаемыеУзлы.Вставить("meta", "ЭлементМетаHTML");
Для Каждого Пара Из ОжидаемыеУзлы Цикл
    Узел = Документ.ПолучитьЭлементПоИдентификатору(Пара.Ключ);
    Если Узел = Неопределено Тогда
        ВызватьИсключение "Не найден учебный элемент " + Пара.Ключ;
    КонецЕсли;
    Если ТипЗнч(Узел) <> Тип(Пара.Значение) Тогда
        ВызватьИсключение "Тип учебного элемента отличается от подготовки: " + Пара.Ключ;
    КонецЕсли;
    Узел.УстановитьПользовательскиеДанные("guide-check", 3);
    Сообщить(Узел.ПолучитьПользовательскиеДанные("guide-check") = 3);
    Сообщить(Не Узел.ЕстьАтрибут("guide-check"));
КонецЦикла;

Разбор по шагам

1. УстановитьПользовательскиеДанные прикрепляет служебные данные к объекту дерева.

2. Ключ guide-check собственный и одинаково проверяется у каждого подготовленного узла.

3. ПолучитьПользовательскиеДанные возвращает число, а не строку HTML-атрибута.

4. ЕстьАтрибут показывает, что HTML-атрибут с этим именем не создан.

Как проверить результат

1. Две проверки в каждом из одиннадцати блоков дают Истина.

2. При сериализации в отдельном уроке не используйте такие отметки как гарантированный способ передачи данных другому приложению.

Ожидаемый результат

Разделены служебные данные объекта и разметка документа.

На что обратить внимание

1. Не храните секреты в служебных данных, рассчитывая на их доступность или очистку в любой реализации.

2. Пользовательские данные не являются настройками пользователя информационной базы.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.