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
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. |
const el = document.getElementById("app");
el.replace(`<div id="app"><h1>Actualizado</h1></div>`);
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. |
window.enableSPA();
// Excluir un enlace puntual con <a href="/pdf" data-no-spa>Descargar</a>
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. |
// Compara atributos, hijos y texto en una sola pasada
document.body.replace(newDoc.body);
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. |
// Mismo nodo antes y después del parche
const ref = app.firstElementChild;
app.replace(nuevoHTML);
console.log(app.firstElementChild === ref); // true