Обойти дерево: ребёнок, сосед и родитель отличаются от индекса массива

В своём контейнере создаём три текста без пробелов между ними. ОбходДереваDOM перемещает текущую позицию, сохраняя заданный корень.

Подготовка

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");
Если Форма = Неопределено Тогда
    ВызватьИсключение "Не найден учебный элемент order";
КонецЕсли;
Если ТипЗнч(Форма) <> Тип("ЭлементФормаHTML") Тогда
    ВызватьИсключение "Неожиданный тип учебного элемента order";
КонецЕсли;
Блок = Документ.СоздатьЭлемент("guide-section");
Если ТипЗнч(Блок) <> Тип("ЭлементHTML") Тогда
    ВызватьИсключение "Учебный контейнер должен иметь общий тип ЭлементHTML";
КонецЕсли;
Форма.ДобавитьДочерний(Блок);
Первый = Документ.СоздатьТекстовыйУзел("Книга");
Второй = Документ.СоздатьТекстовыйУзел(" / ");
Третий = Документ.СоздатьТекстовыйУзел("Ручка");
Блок.ДобавитьДочерний(Первый);
Блок.ДобавитьДочерний(Второй);
Блок.ДобавитьДочерний(Третий);
Обход = Документ.СоздатьОбходДерева(Блок);
Сообщить(Обход.Корень = Блок);
Сообщить(Обход.ПервыйДочерний() = Первый);
Сообщить(Обход.СледующийСоседний() = Второй);
Сообщить(Обход.ПредыдущийСоседний() = Первый);
Сообщить(Обход.РодительскийУзел() = Блок);
Сообщить(Обход.ПоследнийДочерний() = Третий);
Сообщить(Обход.ТекущийУзел = Третий);
Сообщить(Обход.СледующийСоседний() = Неопределено);
Сообщить(Обход.ТекущийУзел = Третий);
Обход.ТекущийУзел = Блок;
Сообщить(Обход.ПредыдущийУзел() = Неопределено);
Сообщить(Обход.СледующийУзел() = Первый);
Сообщить(Обход.ПредыдущийУзел() = Блок);
Сообщить("Раскрывать ссылки: " + Строка(Обход.РаскрыватьСсылкиНаСущности));
Сообщить("Фильтр: " + Строка(Обход.Фильтр));

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

1. Контейнер содержит ровно три текстовых узла, поэтому порядок не зависит от пробелов исходной HTML-строки.

2. Методы обхода перемещают ТекущийУзел, но не перемещают узлы дерева.

3. Когда соседа нет, возвращается Неопределено, а текущая позиция остаётся прежней.

4. Назначением ТекущийУзел возвращаемся в корень; обход не выходит к форме-родителю за его пределами.

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

1. Первые двенадцать сравнений Истина: корректная навигация и границы собственного контейнера.

2. Последние две строки показывают реальные настройки обхода; не обещаем определённого представления объекта фильтра.

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

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

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

1. Не обращайтесь к Данные у Неопределено на границе.

2. Чтение свойства Фильтр не превращает строковый JSON в объект ФильтрУзловDOM.

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