KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen