---
title: CustomElementRegistry.upgrade()
slug: Web/API/CustomElementRegistry/upgrade
tags:
    - API
    - CustomElementRegistry
    - Method
    - Reference
    - Upgrade
    - Web Components
    - custom elements
browser-compat: api.CustomElementRegistry.upgrade
---

<p>{{APIRef("CustomElementRegistry")}}</p>
<p>
    O <code><strong>upgrade()</strong></code> é um método de {{domxref("CustomElementRegistry")}} a interface atualiza todos os shadow-containing custom elements em um {{domxref("Node")}} da
    subárvore, mesmo antes de estarem conectados ao principal documento.
</p>

<h2 id="Syntax">Syntax</h2>

<pre class="brush: js">
customElements.upgrade(<em>root</em>);
</pre>

<h3 id="Parameters">Parâmetros</h3>

<dl>
    <dt><code>root</code></dt>
    <dd>
        Uma instância de {{domxref("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.
    </dd>
</dl>

<h3 id="Return_value">Valor de retorno</h3>

<p>Void.</p>

<h2 id="Examples">Exemplos</h2>

<p>Retirado de <a href="https://html.spec.whatwg.org/multipage/custom-elements.html#dom-customelementregistry-upgrade">HTML spec</a>:</p>

<pre class="brush: 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!
</pre>

<h2 id="Specifications">Especificações</h2>

{{Specifications}}

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat}}</p>