CustomElementRegistry.upgrade()

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.

O upgrade() é um método de CustomElementRegistry a interface atualiza todos os shadow-containing custom elements em um Node da subárvore, mesmo antes de estarem conectados ao principal documento.

Syntax

js
customElements.upgrade(root);

Parâmetros

root

Uma instância de Node com shadow-containing os elementos descendentes que serão atualizados. Se não houver elementos descendentes que possam ser atualizados, nenhum erro será emitido.

Valor de retorno

Void.

Exemplos

Retirado de HTML spec:

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

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

console.assert(!(el instanceof SpiderMan)); // Ainda não atualizado

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

Especificações

Specification
HTML Standard
# dom-customelementregistry-upgrade-dev

Compatibilidade com navegadores

BCD tables only load in the browser