Método compareDocumentPosition() del elemento HTML DOM

Definición y uso

compareDocumentPosition() El método compara dos nodos y devuelve un entero que describe su posición en el documento:

Valor Significado
1 Los nodos no pertenecen al mismo documento.
2 El primer nodo está después del segundo nodo.
4 El primer nodo está antes del segundo nodo.
8 El primer nodo está contenido dentro del segundo nodo.
16 El segundo nodo está contenido dentro del primer nodo.
32 El nodo es una propiedad del mismo elemento.

Comentarios

El valor devuelto también puede ser una combinación de valores.

El valor 20 indica que el segundo nodo está dentro del primer nodo (16) y el primer nodo está antes del segundo nodo (4).

Ejemplo

"p1" en comparación con "p2":

const p1 = document.getElementById("p1");
const p2 = document.getElementById("p2");
let position = p1.compareDocumentPosition(p2);

Prueba tú mismo

Sintaxis

node.compareDocumentPosition(node)

Parámetro

Parámetro Descripción
Node Requerido. El nodo con el que se debe comparar el nodo actual.

Valor devuelto

Tipo Descripción
Número La posición de comparación entre dos nodos.
Valor Significado
1 Los nodos no pertenecen al mismo documento.
2 El primer nodo está después del segundo nodo.
4 El primer nodo está antes del segundo nodo.
8 El primer nodo está contenido dentro del segundo nodo.
16 El segundo nodo está contenido dentro del primer nodo.
32 El nodo es una propiedad del mismo elemento.

Compatibilidad del navegador

element.compareDocumentPosition() Es una característica del nivel DOM 1 (1998).

Todos los navegadores lo soportan completamente:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Soporte 9-11 Soporte Soporte Soporte Soporte