Document : propriété customElementRegistry

Limited availability

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La propriété en lecture seule customElementRegistry de l'interface Document retourne l'objet CustomElementRegistry associé à ce document, ou null si aucun n'a été défini.

Pour les documents associés à une fenêtre (Window) (comme le document principal d'une page), il s'agit du CustomElementRegistry global qui est également accessible avec la propriété window.customElements. Les documents créés de manière programmatique (par exemple, avec DOMImplementation.createHTMLDocument()) ont par défaut un registre d'éléments personnalisés null.

Cette propriété est également disponible sur les objets ShadowRoot avec le même nom de propriété customElementRegistry.

Cet exemple montre que le customElementRegistry du document principal est le même registre global accessible avec window.customElements, tandis que les documents créés de manière programmatique avec DOMImplementation.createHTMLDocument() ont par défaut un registre null.

// Le registre du document principal est le registre global :
console.log(document.customElementRegistry === window.customElements); // true (pour les documents associés à une fenêtre)

// Les documents créés de manière programmatique ont un registre nul :
const newDoc = document.implementation.createHTMLDocument("Nouveau document");
console.log(newDoc.customElementRegistry); // null