Окно: свойство customElements

Свойство customElements только для чтения интерфейса Window возвращает ссылку на объект CustomElementRegistry, который можно использовать для регистрации новых пользовательских элементов и получения информации о ранее зарегистрированных пользовательских элементах.

Наиболее распространённый пример использования этого свойства — получение доступа к методу CustomElementRegistry.define() для определения и регистрации нового пользовательского элемента, например:

let customElementRegistry = window.customElements;
customElementRegistry.define("my-custom-element", MyCustomElement);

Однако, он обычно сокращается до чего-то вроде следующего:

customElements.define(
  "element-details",
  class extends HTMLElement {
    constructor() {
      super();
      const template = document.getElementById(
        "element-details-template",
      ).content;
      const shadowRoot = this.attachShadow({ mode: "open" }).appendChild(
        template.cloneNode(true),
      );
    }
  },
);

Дополнительные примеры использования см. в нашем репозитории web-components-examples.