Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje