Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

customElements.get — recuperare il costruttore di un elemento personalizzato

customElements.get(name) restituisce in modo sincrono il costruttore registrato con un nome, oppure undefined. Controlla una definizione nel registro, non la presenza di un elemento nel documento.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

customElements.get(name)

customElements.get(name) legge una definizione dal registro window.customElements. Restituisce il costruttore registrato oppure undefined se il nome non è presente. La corrispondenza distingue tra maiuscole e minuscole; il metodo non converte il nome in lettere minuscole.

Il risultato è un costruttore, non un’istanza né un elenco di nodi DOM. La chiamata non crea e non registra nulla. Viene controllato solo il registro destinatario, non tutti i registri della pagina.

La ricerca è sincrona e non attende una registrazione successiva. Per attendere, usa customElements.whenDefined(name). Se il nome di tipo stringa è sconosciuto o non valido, get() restituisce undefined invece di generare un errore di convalida del nome.

Questa è una Web API specificata dall’HTML Living Standard, non una funzionalità di una particolare edizione di ECMAScript. La tabella di compatibilità dello standard indica Chrome 54+, Firefox 63+ e Safari 10.1+. La presenza di Node 24 in un repository non dimostra la disponibilità di questa API del browser.

Esempi

(() => {
  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);
})();

Risultato

undefined
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti