CKTIS / JavaScript
customElements.get — obter o construtor de um elemento personalizado
customElements.get(name) devolve sincronamente o construtor registado com um nome, ou undefined. Verifica uma definição no registo, não a presença de um elemento no documento.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
customElements.get(name)customElements.get(name) lê uma definição do registo window.customElements. Devolve o construtor registado ou undefined se o nome não existir. A correspondência distingue maiúsculas de minúsculas; o método não converte o nome para minúsculas.
O resultado é um construtor, não uma instância nem uma lista de nós DOM. A chamada não cria nem regista nada. Verifica apenas o registo em causa, não todos os registos da página.
A consulta é síncrona e não espera por um registo posterior. Para esperar, utiliza customElements.whenDefined(name). Se o nome em formato de texto for desconhecido ou inválido, get() devolve undefined, em vez de gerar um erro de validação do nome.
Esta é uma API Web especificada pelo HTML Living Standard, não uma funcionalidade de uma edição específica de ECMAScript. A tabela de compatibilidade da norma indica Chrome 54+, Firefox 63+ e Safari 10.1+. A presença de Node 24 num repositório não comprova a disponibilidade desta API de navegador.
Exemplos
(() => {
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.