CKTIS / JavaScript
customElements.get — obtener el constructor de un elemento personalizado
customElements.get(name) devuelve de forma síncrona el constructor registrado con un nombre, o undefined. Comprueba una definición del registro, no si hay un elemento en el documento.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
customElements.get(name)customElements.get(name) lee una definición del registro window.customElements. Devuelve el constructor registrado o undefined si el nombre no está presente. La comparación distingue entre mayúsculas y minúsculas; el método no convierte el nombre a minúsculas.
El resultado es un constructor, no una instancia ni una lista de nodos DOM. La llamada no crea ni registra nada. Solo comprueba el registro al que se llama, no todos los registros de la página.
La consulta es síncrona y no espera a que se produzca un registro posterior. Usa customElements.whenDefined(name) para esperar. Si el nombre de tipo cadena es desconocido o no válido, get() devuelve undefined en lugar de producir un error de validación del nombre.
Esta es una API web especificada por el HTML Living Standard, no una característica de una edición concreta de ECMAScript. La tabla de compatibilidad del estándar indica Chrome 54+, Firefox 63+ y Safari 10.1+. Que un repositorio incluya Node 24 no demuestra que esta API de navegador esté disponible.
Ejemplos
(() => {
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);
})();Resultado
undefined true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.