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.

serializableShadowRoot インターフェイスの読み取り専用プロパティで、このシャドウルートがシリアライズ可能であれば、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;

仕様書

Specification
DOM
# dom-shadowroot-serializable

ブラウザーの互換性