Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

customElements.get — récupérer le constructeur d’un élément personnalisé

customElements.get(name) renvoie de manière synchrone le constructeur enregistré sous un nom, ou undefined. La méthode vérifie une définition dans un registre, et non la présence d’un élément dans le document.

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

Syntaxe

customElements.get(name)

customElements.get(name) lit une définition dans le registre window.customElements. La méthode renvoie le constructeur enregistré, ou undefined si le nom est absent. La correspondance distingue les majuscules et les minuscules ; la méthode ne convertit pas le nom en minuscules.

Le résultat est un constructeur, et non une instance ni une liste de nœuds DOM. L’appel ne crée et n’enregistre rien. Seul le registre concerné est vérifié, pas tous les registres de la page.

La recherche est synchrone et n’attend pas un enregistrement ultérieur. Utilisez customElements.whenDefined(name) pour attendre. Pour un nom sous forme de chaîne inconnu ou invalide, get() renvoie undefined au lieu de produire une erreur de validation du nom.

Il s’agit d’une API Web définie par le HTML Living Standard, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Le tableau de compatibilité du standard indique Chrome 54+, Firefox 63+ et Safari 10.1+. La présence de Node 24 dans un dépôt ne prouve pas que cette API de navigateur est disponible.

Exemples

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

Résultat

undefined
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources