Dokument: customElementRegistry Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die schreibgeschützte Eigenschaft customElementRegistry der Document Schnittstelle gibt das CustomElementRegistry-Objekt zurück, das mit diesem Dokument verbunden ist, oder null, wenn keines festgelegt wurde.
Für Dokumente, die mit einem Window verbunden sind (wie das Hauptdokument einer Seite), ist dies das globale CustomElementRegistry, das auch über die window.customElements-Eigenschaft zugänglich ist. Programmgesteuert erstellte Dokumente (zum Beispiel über DOMImplementation.createHTMLDocument()) haben standardmäßig ein null-Custom-Element-Registry.
Diese Eigenschaft ist auch auf ShadowRoot-Objekten über denselben Eigenschaften-Namen customElementRegistry 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 erstellte Dokumente über DOMImplementation.createHTMLDocument() standardmäßig eine null-Registry haben.
// 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 |