CustomElementRegistry.get()

The get() method of the CustomElementRegistry interface returns the constructor for a previously-defined custom element.

Syntax

constructor = customElements.get(name);

Parameters

name
The name of the custom element whose constructor you want to return a reference to.

Return value

The constructor for the named custom element, or undefined if there is no custom element definition with that name.

Examples

customElements.define('my-paragraph',
  class extends HTMLElement {
    constructor() {
      let templateContent = document.getElementById('my-paragraph').content;
      super() // returns element this scope
        .attachShadow({mode: 'open'}) // sets AND returns this.shadowRoot
        .append(templateContent.cloneNode(true));
  }
})

// Return a reference to the my-paragraph constructor
let ctor = customElements.get('my-paragraph');

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'customElements.get()' in that specification.
Living Standard Initial definition.

Browser compatibility

BCD tables only load in the browser