CKTIS / JavaScript
Range — un rango vivo en el árbol DOM
Range describe un fragmento del DOM entre dos límites. Permite extraer, eliminar e insertar contenido, y sus límites responden automáticamente a los cambios del árbol.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const range = document.createRange();
range.setStart(node, startOffset);
range.setEnd(node, endOffset);
range.extractContents();
range.insertNode(node);Range es un rango vivo definido por dos pares de nodo y desplazamiento. Se crea con document.createRange() o new Range(). Es una API web del estándar DOM, no una característica de una edición concreta de ECMAScript; que Node 24 esté en un repositorio no demuestra que esté disponible. El ejemplo requiere un DOM de navegador.
Range.startOffset y Range.endOffset cuentan unidades de código UTF-16 en CharacterData, pero en los elementos cuentan nodos hijos, no caracteres. Range.commonAncestorContainer devuelve el nodo compartido más profundo que contiene ambos límites; puede ser el propio nodo de texto. Range.collapsed significa que los límites son idénticos, no simplemente que el texto esté vacío.
Range.extractContents() elimina contenido y devuelve un DocumentFragment: los nodos contenidos por completo se mueven, mientras que las estructuras contenidas solo en parte se copian según sea necesario. Range.deleteContents() elimina sin devolver un fragmento. Ambas operaciones colapsan el rango. Range.insertNode(node) inserta al principio en lugar de reemplazar el contenido; puede dividir un nodo de texto y expandir un rango colapsado.
Range.setStartAfter(node) sitúa el inicio después del nodo dentro de su padre; el nodo debe tener padre. Range.collapse(true) colapsa al inicio, mientras que Range.collapse(false) o Range.collapse() colapsa al final. Range.cloneRange() crea un rango vivo independiente con los mismos límites, no una copia del DOM ni una instantánea inmutable: las mutaciones posteriores pueden afectar a ambos rangos.
Ejemplos
(() => {
const host = document.createElement('div');
host.textContent = 'ABCDE';
const range = document.createRange();
range.setStart(host.firstChild, 1);
range.setEnd(host.firstChild, 4);
console.log(range.commonAncestorContainer === host.firstChild);
console.log(range.startOffset, range.endOffset, range.collapsed);
const copy = range.cloneRange();
copy.collapse(true);
console.log(copy.collapsed, range.collapsed);
const fragment = range.extractContents();
console.log(fragment.textContent, host.textContent, range.collapsed);
const mark = document.createElement('mark');
mark.appendChild(fragment);
range.insertNode(mark);
range.setStartAfter(mark);
range.collapse(true);
console.log(host.textContent, range.startOffset, range.endOffset);
range.selectNode(mark);
range.deleteContents();
console.log(host.textContent, range.collapsed);
})();Resultado
true 1 4 false true false BCD AE true ABCDE 2 2 AE true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.