getHTML() はElement インターフェイスのメソッドで、要素の DOM を HTML 文字列にシリアライズするために使用します。

このメソッドは、シャドウルートに含まれる子ノードのシリアライズを有効にするオプション引数を提供します。このオプションによって、serializable として設定されている入れ子のシャドウルートや、ShadowRoot オブジェクトの指定された配列を含めることができます。

引数がない場合、シャドウルートである子ノードはシリアライズされず、このメソッドはElement.innerHTML の値を読み取るのと同じ方法で動作します。

構文

getHTML(options)

引数

options省略可

以下のオプション引数を持つオプションオブジェクトです。

serializableShadowRoots

論理値で、serializable なシャドウルートを含めるかどうかを指定します。既定値はfalse です。

shadowRoots

シリアライズするShadowRoot オブジェクトの配列。これらはserializable としてマークされているかどうかや、開いているか閉じられているかに関係なく含まれます。既定値は空の配列です。

返値

要素の HTML シリアライズを表す文字列です。

例外

なし。

仕様書

ブラウザーの互換性

関連情報

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