ShadowRoot: метод getHTML()

Базовая версия 2024

Новая возможность

С сентября 2024 года эта функция работает на последних устройствах и версиях браузеров. Возможно, она не будет работать на старых устройствах или браузерах.

Метод getHTML() интерфейса ShadowRoot используется для сериализации DOM тенированного корня в строку HTML.

Метод принимает аргумент options, который позволяет сериализовать дочерние узлы, являющиеся тенированными корнями. Options можно использовать для включения вложенных тенированных корней, которые были установлены как serializable, и/или указанного массива ShadowRoot объектов, которые могут быть открытыми или закрытыми.

Без аргументов дочерние узлы, являющиеся тенированными корнями, не сериализуются, и этот метод ведет себя так же, как чтение значения Element.innerHTML.

Синтаксис

const html = shadowRoot.getHTML(options)

Параметры

options Необязательно

Объект options с необязательными параметрами:

serializableShadowRoots: Логическое значение, указывающее, нужно ли включать сериализуемые тенированные корни. Значение по умолчанию — false.
shadowRoots: Массив ShadowRoot объектов для сериализации. Они включаются независимо от того, помечены ли они как serializable, или открыты или закрыты. Значение по умолчанию — пустой массив.

Возвращаемое значение

Строка, представляющая HTML-сериализацию тенированного корня.

Исключения

Нет.

Спецификации

Спецификация
HTML # dom-shadowroot-gethtml

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getHTML`	125	125	128	111	18	125	128	83	18	27.0	125

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot/getHTML