EasyJS v0.0.1

Documentación y API

Referencia técnica de EasyJS: HTMLElement.prototype.replace(), algoritmo de reconciliación del DOM, modo SPA declarativo y comparativa frente a innerHTML.

Versión v0.0.1 Vanilla JS · MIT
Núcleo DOM

Parcheo nativo HTMLElement.prototype.replace()

Guía detallada →

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

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.
replace.js
javascript
const el = document.getElementById("app");
el.replace(`<div id="app"><h1>Actualizado</h1></div>`);
Navegación sin recarga

Modo SPA integrado enableSPA() / disableSPA()

Guía detallada →

Intercepta enlaces del mismo origen, descarga la nueva página vía fetch y parchea document.documentElement con .replace().

window.enableSPA(): void | window.disableSPA(): void
Opción / API Tipo · Uso Descripción
<html spa>atributo
HTML boolean
defecto: desactivado
Activa automáticamente el modo SPA al cargar src/spa.js.
window.enableSPA()función
() => void
defecto: —
Registra los listeners click y popstate para navegación SPA mediante fetch + .replace().
window.disableSPA()función
() => void
defecto: —
Desactiva el modo SPA y devuelve la navegación normal al navegador.
data-no-spaatributo
en enlaces <a>
defecto: —
Excluye un enlace interno específico de la intercepción SPA.
spa.js
javascript
window.enableSPA();
// Excluir un enlace puntual con <a href="/pdf" data-no-spa>Descargar</a>
Arquitectura

Reconciliación paso a paso

Guía detallada →

Detalles internos de updateElementNode, updateAttributes y updateChildren en src/replace.js.

updateElementNode(original, updated) → updateAttributes + updateChildren
Fase Detalle técnico Descripción
Tag mismatchregla
replaceWith()
defecto: fallback
Si cambia la etiqueta del nodo (p. ej. div → span), sustituye solo ese subárbol.
Text nodesregla
textContent
defecto: in-place
Actualiza textContent únicamente cuando el texto difiere, evitando repintados.
diff-flow.js
javascript
// Compara atributos, hijos y texto en una sola pasada
document.body.replace(newDoc.body);
Rendimiento

Por qué usar .replace()

Guía detallada →

Conservación de nodos DOM, estabilidad de memoria y preservación del estado interactivo frente a innerHTML.

innerHTML (0% nodos conservados) vs EasyJS .replace() (100% nodos conservados)
Métrica innerHTML vs EasyJS Descripción
Conservación DOMmétrica
0% vs 100%
defecto: EasyJS gana
Reutiliza los nodos existentes en lugar de destruir y recrear todo el contenedor.
Foco y scrollestado
Perdido vs Intacto
defecto: Preservado
Mantiene selección en inputs, scroll interno, listeners y reproducción de vídeo.
benchmark.js
javascript
// Mismo nodo antes y después del parche
const ref = app.firstElementChild;
app.replace(nuevoHTML);
console.log(app.firstElementChild === ref); // true