Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ResizeObserver.observe — observar el tamaño de un elemento

ResizeObserver.observe registra un elemento para recibir notificaciones asíncronas sobre su tamaño. La opción box selecciona el área observada.

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

observer.observe(target, { box: "content-box" });

observer.observe(target, options) acepta un Element y devuelve undefined. Las notificaciones llegan al callback del observador durante el renderizado, no de forma síncrona.

box es "content-box" (contenido) de forma predeterminada; "border-box" también incluye el padding y los bordes, mientras que "device-pixel-content-box" mide el contenido en píxeles enteros del dispositivo. Esta selección controla cuándo se activan las notificaciones, no los campos disponibles en la entrada. Las transformaciones CSS no activan observaciones.

Volver a llamar a observe para el mismo elemento con el mismo valor de box no tiene efecto en Chromium. No des por hecho que esa llamada sustituya el registro o restablezca su estado de notificación en todos los navegadores. unobserve(target) elimina uno; disconnect() los elimina todos. Evita los cambios cíclicos de tamaño en el callback. Es una API web, no una característica de ECMAScript; Node 24 no demuestra la compatibilidad de los navegadores.

Ejemplos

const target = document.createElement("div");
target.style.cssText = "all: initial; display: block; width: 120px; height: 40px;";
document.body.append(target);

const observer = new ResizeObserver(([entry]) => {
  console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
  observer.disconnect();
  target.remove();
});
observer.observe(target, { box: "content-box" });

Resultado

120 x 40

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.

Fuentes