Dokument: customElementRegistry-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die schreibgeschützte Eigenschaft customElementRegistry der Schnittstelle Document gibt das diesem Dokument zugeordnete CustomElementRegistry-Objekt zurück oder null, wenn keines festgelegt wurde.
Für Dokumente, die einem Window zugeordnet sind (etwa das Hauptdokument einer Seite), ist dies die globale CustomElementRegistry, die auch über die Eigenschaft window.customElements zugänglich ist. Programmgesteuert erstellte Dokumente (beispielsweise über DOMImplementation.createHTMLDocument()) besitzen standardmäßig eine null-Custom-Element-Registry.
Diese Eigenschaft ist über denselben Eigenschaftsnamen customElementRegistry auch für ShadowRoot-Objekte verfügbar.
Wert
Ein CustomElementRegistry-Objekt oder null.
Beispiele
Zugriff auf die Custom-Element-Registry eines Dokuments
Dieses Beispiel zeigt, dass die customElementRegistry des Hauptdokuments dieselbe globale Registry ist, die über window.customElements verfügbar ist, während programmgesteuert über DOMImplementation.createHTMLDocument() erstellte Dokumente standardmäßig eine null-Registry besitzen.
// The main document's registry is the global one:
console.log(document.customElementRegistry === window.customElements); // true (for Window-associated documents)
// Documents created programmatically have a null registry:
const newDoc = document.implementation.createHTMLDocument("New document");
console.log(newDoc.customElementRegistry); // null
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-documentorshadowroot-customelementregistry |