CKTIS / JavaScript
ResizeObserver — observar el tamaño de un elemento
ResizeObserver informa de los tamaños de los elementos aunque la ventana no cambie de tamaño. Permite que un componente responda al espacio disponible sin consultar el DOM repetidamente.
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 observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();ResizeObserver es una API del navegador, no una función de ECMAScript; Node 24 no confirma que esté disponible. El evento resize se dispara en Window cuando cambia el tamaño de la ventana, mientras que ResizeObserver notifica los cambios de tamaño de un elemento observado. Las notificaciones son asíncronas y se agrupan durante el renderizado.
observe() observa content-box de forma predeterminada. border-box incluye el relleno y los bordes, mientras que device-pixel-content-box mide el contenido en píxeles enteros del dispositivo. La opción box selecciona el desencadenante, no filtra los campos del resultado.
El callback recibe entries y el observador. Una entrada contiene target, contentRect y matrices de tamaños como contentBoxSize; sus inlineSize y blockSize dependen del modo de escritura. contentRect.width y contentRect.height describen las dimensiones físicas del contenido.
Evita los cambios de tamaño en el callback que creen bucles de realimentación: el navegador puede informar de un error de bucle de observación de redimensionamiento. Las transformaciones CSS por sí solas no activan notificaciones. unobserve(element) detiene una observación y disconnect() las detiene todas. Comprueba que la API y las opciones necesarias estén disponibles en los navegadores de destino.
Ejemplos
(() => {
if (typeof ResizeObserver !== "function") {
throw new Error("ResizeObserver unavailable");
}
const box = document.createElement("div");
box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
document.body.append(box);
const observer = new ResizeObserver(([entry]) => {
console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
observer.disconnect();
box.remove();
});
observer.observe(box, { 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.