Element: getHTML() 方法

Baseline 2024

新推出

自 2024 年 9 月起，此功能已可在最新裝置和瀏覽器版本上使用。此功能可能無法在舊裝置或瀏覽器上使用。

Element 介面的 getHTML() 方法用於將元素的 DOM 序列化為 HTML 字串。

該方法提供了一個 options 引數，可以用於序列化 shadow roots 的子節點。這些選項可以用來包含已設定為 serializable 的巢狀 shadow roots，或/和指定的 ShadowRoot 物件陣列，這些物件可以是 open 或 closed 的。

如果不提供引數，shadow roots 的子節點將不會被序列化，此方法與讀取 Element.innerHTML 的值行為相同。

請注意，當 < 和 > 字元出現在屬性值中時，某些瀏覽器會將其序列化為 < 和 >（請參閱瀏覽器相容性）。這是為了防止潛在的安全漏洞（變異 XSS），其中攻擊者可以精心構造繞過淨化函式的輸入，從而實現跨站指令碼（XSS）攻擊。

語法

getHTML(options)

一個包含以下可選引數的 options 物件

serializableShadowRoots: 一個布林值，指定是否包含 serializable 的 shadow roots。預設值為 false。
shadowRoots: 要序列化的 ShadowRoot 物件陣列。這些物件將被包含，無論它們是否標記為 serializable，或它們是 open 還是 closed。預設值是一個空陣列。