大网数据广告活动
Web 标准与前端开发

Element:getHTML() 方法

· 52CE 我爱测

Element 接口的 **`getHTML()`** 方法将元素的 DOM 序列化为 HTML 字符串。

DOM

Element 接口的 getHTML() 方法将元素的 DOM 序列化为 HTML 字符串。

该方法提供选项参数,可序列化作为影子根的子节点。选项可包含已设为 ShadowRoot/serializable 的嵌套影子根,和/或指定的 ShadowRoot 对象数组(可以是公开的或不公开的)。

不带参数时,不会序列化作为影子根的子节点,行为与读取 Element.innerHTML 的值相同。

请注意,某些浏览器会将属性值中的 < 和 > 序列化为 &lt; 和 &gt;(参见浏览器兼容性)。这用于防止潜在的安全漏洞(突变型 XSS):攻击者可能构造绕过净化函数的输入,从而实施跨站脚本(XSS)攻击。

语法

getHTML(options)

参数

  • options
    • : 含以下可选参数的选项对象:
      • serializableShadowRoots
        • : 指定是否包含 ShadowRoot/serializable影子根的布尔值,默认值为 false。
      • shadowRoots
        • : 要序列化的 ShadowRoot 对象数组。无论是否标记为 serializable,以及是公开还是不公开,都会包含它们。默认值为空数组。

返回值

表示元素 HTML 序列化结果的字符串。

异常

无。

规范

浏览器兼容性

参见

  • ShadowRoot.getHTML()
  • Element.innerHTML
  • Element.setHTMLUnsafe()
  • ShadowRoot.setHTMLUnsafe()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。