CustomElementRegistry.upgrade()
The upgrade()
method of the
CustomElementRegistry
interface upgrades all shadow-containing custom
elements in a Node
subtree, even before they are connected to the main
document.
Syntax
customElements.upgrade(root);
Parameters
root
-
A
Node
instance with shadow-containing descendant elements that are to be upgraded. If there are no descendant elements that can be upgraded, no error is thrown.
Return value
Void.
Examples
Taken from the HTML spec:
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!
Specifications
Specification |
---|
HTML Standard # dom-customelementregistry-upgrade-dev |
Browser compatibility
BCD tables only load in the browser