Element: getHTML()-Methode
Baseline 2024
Newly available
Since September 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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
getHTML(options)
Parameter
optionsOptional-
Ein Optionsobjekt mit den folgenden optionalen Parametern:
serializableShadowRoots-
Ein Boolescher Wert, der angibt, ob
serializableShadow-Roots einbezogen werden sollen. Der Standardwert istfalse. shadowRoots-
Ein Array von
ShadowRoot-Objekten, die serialisiert werden sollen. Diese werden unabhängig davon einbezogen, ob sie alsserializablemarkiert 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