WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ResizeObserver.observe — Elementgröße beobachten

ResizeObserver.observe registriert ein Element für asynchrone Größenbenachrichtigungen. Die Option box legt den beobachteten Bereich fest.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

observer.observe(target, options) akzeptiert ein Element und gibt undefined zurück. Benachrichtigungen erreichen den Callback des Observers während des Renderings, nicht synchron.

box ist standardmäßig "content-box" (Inhalt); "border-box" umfasst zusätzlich Padding und Rahmen, während "device-pixel-content-box" den Inhalt in ganzzahligen Geräte-Pixeln misst. Diese Auswahl steuert, wann Benachrichtigungen ausgelöst werden, nicht welche Felder der Eintrag enthält. CSS-Transformationen lösen keine Beobachtungen aus.

Ein erneuter Aufruf von observe für dasselbe Element mit demselben box-Wert bleibt in Chromium ohne Wirkung. Verlasse dich nicht darauf, dass ein solcher Aufruf in jedem Browser die Registrierung ersetzt oder ihren Benachrichtigungsstatus zurücksetzt. unobserve(target) entfernt eine Registrierung, disconnect() entfernt alle. Vermeide zyklische Größenänderungen im Callback. Dies ist eine Web-API, kein ECMAScript-Feature; Node 24 belegt keine Browserunterstützung.

Beispiele

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" });

Ergebnis

120 x 40

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen