CKTIS / JavaScript
customElements.get — Konstruktor eines benutzerdefinierten Elements abrufen
customElements.get(name) gibt synchron den unter einem Namen registrierten Konstruktor oder undefined zurück. Die Methode prüft eine Definition im Register, nicht, ob ein Element im Dokument vorhanden ist.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
customElements.get(name)customElements.get(name) liest eine Definition aus dem Register window.customElements. Es gibt den registrierten Konstruktor zurück oder undefined, wenn der Name nicht vorhanden ist. Beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden; die Methode wandelt den Namen nicht in Kleinbuchstaben um.
Das Ergebnis ist ein Konstruktor, keine Instanz und keine Liste von DOM-Knoten. Der Aufruf erstellt oder registriert nichts. Geprüft wird nur das angesprochene Register, nicht jedes Register auf der Seite.
Die Abfrage erfolgt synchron und wartet nicht auf eine spätere Registrierung. Verwende customElements.whenDefined(name), um darauf zu warten. Bei einem unbekannten oder ungültigen Namen als Zeichenfolge gibt get() undefined zurück, statt einen Fehler bei der Namensvalidierung auszulösen.
Dies ist eine Web-API, die im HTML Living Standard festgelegt ist, und keine Funktion einer bestimmten ECMAScript-Ausgabe. Die Kompatibilitätstabelle des Standards nennt Chrome 54+, Firefox 63+ und Safari 10.1+. Node 24 in einem Repository belegt nicht, dass diese Browser-API verfügbar ist.
Beispiele
(() => {
const name = 'cktis-get-demo';
console.log(customElements.get(name));
class DemoElement extends HTMLElement {}
customElements.define(name, DemoElement);
const Constructor = customElements.get(name);
console.log(Constructor === DemoElement);
console.log(new Constructor() instanceof DemoElement);
})();Ergebnis
undefined true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.