EasyJS v0.0.1
Núcleo DOM

Parcheo nativo HTMLElement.prototype.replace()

Extiende todos los elementos HTML con un método inteligente que reconcilia atributos y nodos hijos conservando el estado vivo.

Vanilla JS · MIT
element.replace(newContent: string | HTMLElement): void
Parámetro / Paso Tipo · Comportamiento Descripción
newContentrequerido
string | HTMLElement
defecto: —
Cadena HTML o nodo HTMLElement que representa el nuevo estado del elemento.
updateAttributesinterno
diff de atributos
defecto: automático
Añade, actualiza o retira únicamente los atributos que han cambiado.
updateChildreninterno
reconciliación
defecto: recursivo
Recorre childNodes por posición, actualiza nodos de texto y respeta elementos existentes.
script handlinginterno
<script>
defecto: activo
Solo re-ejecuta etiquetas <script> nuevas o cuyo src/textContent haya cambiado.

Cómo funciona element.replace(newContent)

Al incluir src/replace.js (o el punto de entrada EasyJS.js), cada elemento del DOM dispone de .replace(). Acepta tanto un string HTML como un HTMLElement ya construido.

Secuencia de reconciliación

  1. Etiqueta raíz distinta: si el tagName cambia (por ejemplo <div> por <span>), realiza una sustitución directa con replaceWith().
  2. Atributos: elimina los atributos ausentes y actualiza solo aquellos cuyo valor cambió.
  3. Hijos recursivos: actualiza nodos de texto in-place, añade los nuevos, retira los sobrantes y trata etiquetas <script> nuevas o modificadas para ejecutarlas correctamente.
const panel = document.getElementById('panel');
panel.replace(`
  <div id="panel" class="updated">
    <h2>Estado en vivo</h2>
    <input type="text" placeholder="Tu texto sigue intacto" />
  </div>
`);