ShadowRoot: serializable プロパティ

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.

serializable は ShadowRoot インターフェイスの読み取り専用プロパティで、このシャドウルートがシリアライズ可能であれば、true を返します。

設定されている場合、このシャドウルートは、Element.getHTML() または ShadowRoot.getHTML() メソッドを options.serializableShadowRoots 引数に true を指定して呼び出すことでシリアライズできます。

シャドウルートの serializable プロパティは、シャドウルートが作成された際に指定されます。<template> 要素に shadowrootserializable 属性を（許可された shadowrootmode 値とともに）追加することで宣言的に指定するか、options.serializable 引数を true に設定して Element.attachShadow() を使用します。

値

このシャドウルートがシリアライズ可能であれば true、そうでなければ false。

例

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

// ...

// シリアライズ可能かどうか
let hostElem = shadow.serializable;