Element: customElementRegistry-Eigenschaft
Baseline 2026
Neu verfügbar
Seit Oktober 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die schreibgeschützte Eigenschaft customElementRegistry des Element-Interfaces gibt das diesem Element zugeordnete CustomElementRegistry-Objekt zurück oder null, wenn keines festgelegt wurde.
Die customElementRegistry eines Elements wird festgelegt, wenn das Element erstellt wird (beispielsweise über Document.createElement() mit der Option customElementRegistry oder wenn es in einem Kontext mit einer bereichsbezogenen Registry geparst wird). Sobald sie auf ein CustomElementRegistry-Objekt festgelegt wurde, kann sie nicht mehr geändert werden. Die Registry bestimmt, welche Definitionen von benutzerdefinierten Elementen verwendet werden, wenn das Element aktualisiert wird.
Wert
Ein CustomElementRegistry-Objekt oder null.
Beispiele
Zugriff auf die Custom-Element-Registry eines Elements
Dieses Beispiel erstellt eine bereichsbezogene Registry, fügt sie an eine Shadow-Root an und liest dann die Eigenschaft customElementRegistry von einem Element innerhalb des Shadow Tree aus, um zu bestätigen, dass sie mit der bereichsbezogenen Registry übereinstimmt.
const myRegistry = new CustomElementRegistry();
myRegistry.define(
"my-element",
class extends HTMLElement {
connectedCallback() {
this.textContent = "Hello from scoped registry!";
}
},
);
const host = document.createElement("div");
document.body.appendChild(host);
const shadow = host.attachShadow({
mode: "open",
customElementRegistry: myRegistry,
});
shadow.innerHTML = "<my-element></my-element>";
const el = shadow.querySelector("my-element");
console.log(el.customElementRegistry === myRegistry); // true
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-element-customelementregistry |