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.