ShadowRoot:getHTML() 方法

getHTML()ShadowRoot 接口的方法,用于将 shadow root 的 DOM 序列化为 HTML 字符串。

该方法提供了一个 options 参数,用于启用 shadow root 子节点的序列化。可以使用这些选项来包含已设置为 serializable 的嵌套 shadow root,以及/或者指定的 ShadowRoot 对象数组,这些对象可以是打开的或关闭的。

如果没有参数,则不会序列化作为 shadow root 的子节点,此方法的行为方式与读取 Element.innerHTML 的值相同。

语法

js
const html = shadowRoot.getHTML(options)

参数

options 可选

一个包含以下可选参数的选项对象

serializableShadowRoots

一个布尔值,指定是否包含 serializable shadow root。默认值为 false

shadowRoots

要序列化的 ShadowRoot 对象数组。这些对象无论是否标记为 serializable,或者是否处于打开或关闭状态,都将包含在内。默认值为一个空数组。

返回值

表示 shadow root 的 HTML 序列化的字符串。

异常

无。

规范

规范
HTML 标准
# dom-shadowroot-gethtml

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅