ShadowRoot: serializable-Eigenschaft
Baseline 2024
Neu verfügbar
Seit September 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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
const customElem = document.querySelector("my-shadow-dom-element");
const shadow = customElem.shadowRoot;
// …
// Is it serializable?
const hostElem = shadow.serializable;
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-shadowroot-serializable |