Element: getHTML()-Methode

Die getHTML()-Methode der Element-Schnittstelle wird verwendet, um das DOM eines Elements in eine HTML-Zeichenkette zu serialisieren.

Die Methode bietet ein Optionsargument, das die Serialisierung von Kindknoten ermöglicht, die Shadow-Roots sind. Die Optionen können verwendet werden, um verschachtelte Shadow-Roots einzuschließen, die als serializable festgelegt worden sind, und/oder ein angegebenes Array von ShadowRoot-Objekten, die entweder open oder closed sein können.

Ohne Argumente werden Kindknoten, die Shadow-Roots sind, nicht serialisiert, und diese Methode verhält sich genauso wie das Auslesen des Wertes von Element.innerHTML.

Syntax

js
getHTML(options)

Parameter

options Optional

Ein Optionsobjekt mit den folgenden optionalen Parametern:

serializableShadowRoots

Ein Boolescher Wert, der angibt, ob serializable Shadow-Roots einbezogen werden sollen. Der Standardwert ist false.

shadowRoots

Ein Array von ShadowRoot-Objekten, die serialisiert werden sollen. Diese werden unabhängig davon einbezogen, ob sie als serializable markiert sind oder ob sie open oder closed sind. Der Standardwert ist ein leeres Array.

Rückgabewert

Ein String, der die HTML-Serialisierung des Elements darstellt.

Ausnahmen

Keine.

Spezifikationen

Specification
HTML Standard
# dom-element-gethtml

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch