ShadowRoot: serializable-Eigenschaft

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 schreibgeschützte serializable-Eigenschaft der ShadowRoot-Schnittstelle gibt true zurück, wenn der Shadow-Root serialisierbar ist.

Wenn gesetzt, kann der Shadow-Root durch Aufrufen der Methoden Element.getHTML() oder ShadowRoot.getHTML() mit dem Parameter options.serializableShadowRoots auf true gesetzt serialisiert werden.

Die serializable-Eigenschaft eines Shadow-Roots wird beim Erstellen des Shadow-Roots festgelegt, entweder deklarativ durch Hinzufügen des shadowrootserializable-Attributs auf einem <template>-Element (zusammen mit einem erlaubten shadowrootmode-Wert) oder durch Setzen des options.serializable-Parameters auf true, wenn Element.attachShadow() verwendet wird.

Wert

true, wenn der Shadow-Root serialisierbar ist; andernfalls false.

Beispiele

js
const customElem = document.querySelector("my-shadow-dom-element");
const shadow = customElem.shadowRoot;

// …

// Is it serializable?
const hostElem = shadow.serializable;

Spezifikationen

Specification
DOM
# dom-shadowroot-serializable

Browser-Kompatibilität