Элемент: метод setHTMLUnsafe()

Метод setHTMLUnsafe() интерфейса Element используется для разбора строки HTML в DocumentFragment, который затем заменяет поддерево элемента в DOM. Входной HTML может включать декларативные корни тени.

Суффикс "Unsafe" в имени метода указывает, что метод не очищает и не удаляет потенциально небезопасный ввод, относящийся к XSS, например <script> элементы, и атрибуты содержимого скриптов или обработчиков событий.

Если строка HTML определяет более одного декларативного корня тени в конкретном хосте тени, то создается только первый ShadowRoot — последующие объявления анализируются как <template> элементы внутри этого корня тени.

html

Строка, определяющая HTML для разбора.

Ничего (undefined).

Нет.

Приведенный ниже код демонстрирует, как разобрать строку HTML и вставить её в Element с id target.

const value = "<p>This is a string of text</p>"; // string of HTML

// Get the Element with id "target" and set it with the string.
document.getElementById("target").setHTMLUnsafe(value);

// Result (as a string): "<p>This is a string of text</p>"

• ShadowRoot.setHTMLUnsafe()
• Element.innerHTML
• Document.parseHTMLUnsafe()