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.