CustomElementRegistry: upgrade() 方法

upgrade() 方法是 CustomElementRegistry 接口的方法，用于升级 Node 子树中的所有包含阴影的自定义元素，甚至在它们连接到主文档之前。

语法

js
upgrade(root)

参数

root

一个 Node 实例，其中包含要升级的包含阴影的子元素。如果不存在可以升级的子元素，则不会抛出任何错误。

返回值

无 (undefined).

示例

摘自 HTML 规范

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!

规范

规范
HTML 标准
# dom-customelementregistry-upgrade-dev

浏览器兼容性

BCD 表格仅在浏览器中加载