CustomElementRegistry: upgrade()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die upgrade()-Methode der CustomElementRegistry-Schnittstelle aktualisiert alle Schatten-inhaltigen benutzerdefinierten Elemente in einem Node-Teilbaum, selbst bevor sie mit dem Hauptdokument verbunden sind.

Syntax

js
upgrade(root)

Parameter

root

Eine Node-Instanz mit nachfolgenden Schatten-inhaltigen Elementen, die aktualisiert werden sollen. Wenn es keine nachfolgenden Elemente gibt, die aktualisiert werden können, wird kein Fehler ausgelöst.

Rückgabewert

Keiner (undefined).

Beispiele

Entnommen aus der HTML Spezifikation:

js
const el = document.createElement("spider-man");

class SpiderMan extends HTMLElement {}
customElements.define("spider-man", SpiderMan);

console.assert(!(el instanceof SpiderMan)); // not yet upgraded

customElements.upgrade(el);
console.assert(el instanceof SpiderMan); // upgraded!

Spezifikationen

Specification
HTML Standard
# dom-customelementregistry-upgrade-dev

Browser-Kompatibilität

BCD tables only load in the browser