Document: customElementRegistry プロパティ
Baseline 2026
最近利用可能
2026年10月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
customElementRegistry は Document インターフェイスの読み取り専用プロパティで、この文書に関連付けられた CustomElementRegistry オブジェクトを、設定されていない場合は null を返します。
Window に関連付けられた文書（ページのメイン文書など）の場合、これはグローバルな CustomElementRegistry であり、window.customElements プロパティからもアクセス可能です。プログラムによって作成された文書（例えば DOMImplementation.createHTMLDocument() を使用した場合など）では、デフォルトでカスタム要素レジストリーは null になります。
このプロパティは、ShadowRoot オブジェクト上でも、同時に customElementRegistry というプロパティ名を通じて利用可能です。
値
CustomElementRegistry オブジェクト、または null です。
例
文書のカスタム要素レジストリーへアクセス
この例は、メイン文書の customElementRegistry が window.customElements で利用できるグローバルレジストリーと同じものである一方、DOMImplementation.createHTMLDocument() を用いてプログラムで作成された文書では、デフォルトでレジストリーが null になることを示しています。
js
// メイン文書のレジストリーはグローバルなもの
console.log(document.customElementRegistry === window.customElements); // true （ウィンドウに関連付けられた文書）
// プログラムによって作成された文書では、レジストリーが null になります。
const newDoc = document.implementation.createHTMLDocument("New document");
console.log(newDoc.customElementRegistry); // null
仕様書
| 仕様書 |
|---|
| DOM # dom-documentorshadowroot-customelementregistry |