CKTIS / JavaScript
customElements.get — de constructor van een aangepast element ophalen
customElements.get(name) retourneert synchroon de constructor die onder een naam is geregistreerd, of undefined. De methode controleert een definitie in het register, niet of er een element in het document staat.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
customElements.get(name)customElements.get(name) leest een definitie uit het register window.customElements. De methode retourneert de geregistreerde constructor, of undefined als de naam ontbreekt. Bij het vergelijken wordt onderscheid gemaakt tussen hoofdletters en kleine letters; de methode zet de naam niet om naar kleine letters.
Het resultaat is een constructor, geen instantie of lijst met DOM-nodes. De aanroep maakt of registreert niets. Alleen het aangesproken register wordt gecontroleerd, niet elk register op de pagina.
De zoekactie is synchroon en wacht niet op een latere registratie. Gebruik customElements.whenDefined(name) om daarop te wachten. Bij een onbekende of ongeldige naam als tekenreeks retourneert get() undefined in plaats van een fout bij de naamvalidatie te geven.
Dit is een Web API die is vastgelegd in de HTML Living Standard, geen functie van een bepaalde ECMAScript-editie. De compatibiliteitstabel van de standaard vermeldt Chrome 54+, Firefox 63+ en Safari 10.1+. Dat een repository Node 24 bevat, bewijst niet dat deze browser-API beschikbaar is.
Voorbeelden
(() => {
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);
})();Resultaat
undefined true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.