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.