CKTIS / JavaScript
customElements.get — získání konstruktoru vlastního prvku
customElements.get(name) synchronně vrátí konstruktor registrovaný pod daným názvem, nebo undefined. Kontroluje definici v registru, nikoli přítomnost prvku v dokumentu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
customElements.get(name)customElements.get(name) čte definici z registru window.customElements. Vrátí registrovaný konstruktor, nebo undefined, pokud název chybí. Při porovnávání rozlišuje velká a malá písmena; metoda název nepřevádí na malá písmena.
Výsledkem je konstruktor, nikoli instance ani seznam uzlů DOM. Volání nic nevytváří ani neregistruje. Kontroluje se pouze příslušný registr, nikoli všechny registry na stránce.
Vyhledání je synchronní a nečeká na pozdější registraci. Chcete-li čekat, použijte customElements.whenDefined(name). U neznámého nebo neplatného řetězcového názvu vrátí get() undefined, místo aby vyvolala chybu validace názvu.
Jde o webové API definované v HTML Living Standard, nikoli o funkci konkrétní edice ECMAScriptu. Tabulka kompatibility standardu uvádí Chrome 54+, Firefox 63+ a Safari 10.1+. Přítomnost Node 24 v repozitáři nedokládá dostupnost tohoto API prohlížeče.
Příklady
(() => {
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);
})();Výsledek
undefined true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.