Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

customElements.get — získanie konštruktora vlastného prvku

customElements.get(name) synchrónne vráti konštruktor zaregistrovaný pod daným názvom alebo undefined. Kontroluje definíciu v registri, nie prítomnosť prvku v dokumente.

Verzia: 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) číta definíciu z registra window.customElements. Vráti zaregistrovaný konštruktor alebo undefined, ak názov chýba. Pri porovnávaní rozlišuje veľké a malé písmená; metóda názov neprevádza na malé písmená.

Výsledkom je konštruktor, nie inštancia ani zoznam uzlov DOM. Volanie nič nevytvára ani neregistruje. Kontroluje sa iba príslušný register, nie všetky registre na stránke.

Vyhľadanie je synchrónne a nečaká na neskoršiu registráciu. Ak chcete čakať, použite customElements.whenDefined(name). Pri neznámom alebo neplatnom reťazcovom názve vráti get() undefined, namiesto toho, aby vyvolala chybu validácie názvu.

Ide o webové API definované v HTML Living Standard, nie o funkciu konkrétnej edície ECMAScriptu. Tabuľka kompatibility štandardu uvádza Chrome 54+, Firefox 63+ a Safari 10.1+. Prítomnosť Node 24 v repozitári nedokazuje dostupnosť tohto API prehliadača.

Prí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ýsledok

undefined
true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje