Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

customElements.get — pobieranie konstruktora elementu niestandardowego

customElements.get(name) synchronicznie zwraca konstruktor zarejestrowany pod daną nazwą albo undefined. Sprawdza definicję w rejestrze, a nie obecność elementu w dokumencie.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

customElements.get(name)

customElements.get(name) odczytuje definicję z rejestru window.customElements. Zwraca zarejestrowany konstruktor albo undefined, jeśli nazwy nie znaleziono. Dopasowanie rozróżnia wielkość liter; metoda nie zamienia nazwy na małe litery.

Wynik jest konstruktorem, nie instancją ani listą węzłów DOM. Samo wywołanie niczego nie tworzy ani nie rejestruje. Sprawdzany jest wyłącznie wskazany rejestr, nie wszystkie rejestry na stronie.

Odczyt jest synchroniczny i nie czeka na późniejszą rejestrację. Do oczekiwania służy customElements.whenDefined(name). Nieznana lub niepoprawna nazwa tekstowa daje w get() wynik undefined, a nie błąd walidacji nazwy.

To Web API określone w HTML Living Standard, nie funkcja konkretnej edycji ECMAScript. Tabela zgodności standardu podaje Chrome 54+, Firefox 63+ i Safari 10.1+. Wersja Node 24 w repozytorium nie dowodzi dostępności tego API przeglądarkowego.

Przykłady

(() => {
  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);
})();

Wynik

undefined
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła