EasyJS v0.0.1
v0.0.1 · Diffing DOM nativo + SPA

Manipulación moderna del DOM con EasyJS

Añade diffing y parcheo quirúrgico directamente al prototipo nativo HTMLElement.prototype.replace() e incluye un router SPA ligero sin dependencias.

cdn.jsdelivr.net/gh/PabloTheBlink/EasyJS@main/EasyJS.js
~2,5 KBgzip 0 depsvanilla JS 100%nodos conservados MITopen source
Parcheo en vivo (.replace) replace() #1
Panel reactivo · patch #1 En línea
Última mutación: estado inicial
0 nodos recreados · foco intacto
document.getElementById("panel").replace(newState);
Instalación rápida

Carga directa desde jsDelivr o GitHub

Sin paso de compilación: importa el módulo completo con SPA o carga solo src/replace.js.

ES Module completo (replace + SPA)

EasyJS.js · jsDelivr
html
<!-- Módulo ES completo (replace + SPA) -->
<script type="module"
  src="https://cdn.jsdelivr.net/gh/PabloTheBlink/EasyJS@main/EasyJS.js"
></script>

<!-- Activar modo SPA declarativo -->
<html lang="es" spa>

Script clásico (solo .replace)

src/replace.js · jsDelivr
html
<!-- Script clásico directo (solo diffing .replace) -->
<script
  src="https://cdn.jsdelivr.net/gh/PabloTheBlink/EasyJS@main/src/replace.js"
></script>

<script>
  document.getElementById("app").replace(
    `<div id="app"><h1>Listo</h1></div>`
  );
</script>
Ejemplo rápido

Actualiza el DOM sin destruir el estado

Una única llamada sobre cualquier HTMLElement reconcilia atributos, texto y nodos hijos.

ejemplo-replace.js
javascript
// 1. Selecciona el nodo destino
const app = document.getElementById("app");

// 2. Define el nuevo estado HTML
const newState = `
  <div id="app" class="active">
    <h1>Hola Mundo</h1>
    <p>Actualizado: ${new Date().toLocaleTimeString()}</p>
    <input type="text" placeholder="Escribe aquí..." />
  </div>
`;

// 3. Parchea sin perder el foco ni el texto del input
app.replace(newState);
Sandbox y benchmark

Benchmark real: innerHTML vs .replace()

Ejecuta la comparativa sobre 1.000 elementos DOM reales en tu navegador y comprueba la conservación de nodos.

Benchmark 1.000 nodos
Métrica (1.000 items)innerHTMLEasyJS
Tiempo ejecuciónPulsa ejecutarPulsa ejecutar
Nodos reutilizados0% nodos100% nodos
Foco y listenersPerdidoConservado
Mutación #1Listo
jsDelivr · EasyJS@main/src/replace.js100% nodos conservados
benchmark-replace.js
javascript
// Comparativa en vivo: innerHTML vs EasyJS .replace()
const lista = document.getElementById("lista");

// innerHTML destruye los 1.000 nodos y pierde el foco
// EasyJS muta solo el texto cambiado y conserva 100% de nodos
lista.replace(nuevoEstadoHTML);
Características

Precisión de framework, simplicidad vanilla

Conservación de DOM, estabilidad de memoria y navegación SPA en dos ficheros sin dependencias.

Actualizaciones granulares

Compara atributos, texto y nodos hijos recursivamente, mutando solo las diferencias exactas sin destruir el subárbol.

Preservación total de estado

Mantiene intactos el foco del cursor en inputs, la posición de scroll, los listeners adjuntos y la reproducción de vídeo.

Router SPA en un atributo

Añade el atributo spa a <html> o llama a window.enableSPA() para interceptar enlaces internos con fetch + .replace().

Re-ejecución limpia de scripts

Detecta etiquetas <script> añadidas o modificadas durante un parcheo y las recrea en orden sin re-ejecutar las idénticas.

Estabilidad de memoria

Al reutilizar nodos existentes en vez de destruirlos como innerHTML, evita picos de Garbage Collection en listas grandes.

Cero dependencias y ~2,5 KB

Dos archivos puros en vanilla JavaScript (src/replace.js y src/spa.js) listos para ES Modules o script clásico.

Recetas de uso

Patrones listos para copiar

Desde parcheo puntual de un panel hasta navegación SPA completa con un único atributo.

Parcheo preservando foco

element.replace()

Actualiza títulos, clases y marcas horarias sin interrumpir al usuario mientras escribe dentro de un campo <input>.

patch-dom.js
const app = document.getElementById("app");

const newState = `
  <div id="app" class="active">
    <h1>Hola Mundo</h1>
    <p>Actualizado: ${new Date().toLocaleTimeString()}</p>
    <input type="text" placeholder="Escribe aquí..." />
  </div>
`;

app.replace(newState);

Navegación SPA declarativa

<html spa>

Convierte cualquier web multipágina tradicional en una SPA fluida añadiendo un único atributo en el documento.

spa-auto.html
<html lang="es" spa>
  <head>
    <script type="module"
      src="https://cdn.jsdelivr.net/gh/PabloTheBlink/EasyJS@main/EasyJS.js"
    ></script>
  </head>
  <body>
    <a href="/acerca">Navega sin recargar</a>
    <a href="/salir" data-no-spa>Enlace normal</a>
  </body>
</html>

Activar o desactivar SPA por código

enableSPA()

Controla dinámicamente la intercepción de enlaces e historial popstate desde tu propia lógica de aplicación.

spa-manual.js
// Activar intercepción SPA
window.enableSPA();

// Volver a navegación estándar del navegador
window.disableSPA();

Diff directo entre nodos DOM

HTMLElement

Además de strings HTML, .replace() acepta directamente otro HTMLElement parseado con DOMParser o creado en memoria.

node-diff.js
const html = await fetch("/parcial").then(r => r.text());
const parsed = new DOMParser().parseFromString(html, "text/html");

document.getElementById("panel").replace(
  parsed.getElementById("panel")
);
Referencia técnica

Documentación, blog y evolución

Referencia completa

Documentación y API

Firma de HTMLElement.prototype.replace(), algoritmo de diffing, router SPA y comparativa frente a innerHTML.

Abrir Docs API →