Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes