CKTIS / JavaScript
customElements.get — извличане на конструктора на персонализиран елемент
customElements.get(name) синхронно връща конструктора, регистриран под дадено име, или undefined. Проверява дефиниция в регистъра, а не дали в документа има елемент.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
customElements.get(name)customElements.get(name) прочита дефиниция от регистъра window.customElements. Връща регистрирания конструктор или undefined, ако името липсва. При съпоставянето се прави разлика между главни и малки букви; методът не преобразува името в малки букви.
Резултатът е конструктор, а не екземпляр или списък с DOM възли. Извикването не създава и не регистрира нищо. Проверява се само съответният регистър, а не всички регистри на страницата.
Заявката е синхронна и не изчаква последваща регистрация. За да изчакате, използвайте customElements.whenDefined(name). При неизвестно или невалидно име във вид на низ get() връща undefined, вместо да предизвика грешка при проверка на името.
Това е Web API, зададено в HTML Living Standard, а не функция на конкретно издание на ECMAScript. Таблицата за съвместимост на стандарта посочва Chrome 54+, Firefox 63+ и Safari 10.1+. Наличието на Node 24 в хранилище не доказва, че този API на браузъра е наличен.
Примери
(() => {
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);
})();Резултат
undefined true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.