Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

customElements.get — pridobivanje konstruktorja elementa po meri

customElements.get(name) sinhrono vrne konstruktor, registriran pod določenim imenom, ali undefined. Preveri definicijo v registru, ne pa prisotnosti elementa v dokumentu.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

customElements.get(name)

customElements.get(name) prebere definicijo iz registra window.customElements. Vrne registriran konstruktor ali undefined, če imena ni. Pri primerjanju razlikuje med velikimi in malimi črkami; metoda imena ne pretvori v male črke.

Rezultat je konstruktor, ne primerek ali seznam vozlišč DOM. Klic ne ustvari in ne registrira ničesar. Preveri se samo ciljni register, ne vsi registri na strani.

Iskanje je sinhrono in ne čaka na poznejšo registracijo. Če želiš počakati, uporabi customElements.whenDefined(name). Pri neznanem ali neveljavnem imenu v obliki niza get() vrne undefined, namesto da bi povzročil napako pri preverjanju imena.

To je spletni API, določen v HTML Living Standard, ne funkcija določene izdaje ECMAScripta. Tabela združljivosti standarda navaja Chrome 54+, Firefox 63+ in Safari 10.1+. Prisotnost Node 24 v repozitoriju ne dokazuje, da je ta API brskalnika na voljo.

Primeri

(() => {
  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);
})();

Rezultat

undefined
true
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri