WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Window.getComputedStyle — aufgelöste Stile auslesen

Window.getComputedStyle liest die aufgelösten CSS-Werte eines Elements, nachdem Stylesheets angewendet wurden. Die Methode gibt ein lebendes, schreibgeschütztes Objekt zurück, keine Kopie der Inline-Deklarationen.

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

window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)

Window.getComputedStyle, aufgerufen als window.getComputedStyle(element, pseudoElt), ist eine Browser-API des CSSOM und keine ECMAScript-Funktion. Die Methode wird breit unterstützt; das Vorhandensein von Node 24 belegt ihre Verfügbarkeit nicht. element muss ein Element-Objekt sein. Das optionale pseudoElt, etwa "::before", wählt ein Pseudoelement aus; wird es weggelassen oder auf null gesetzt, ist das Element selbst gemeint.

Das Ergebnis enthält aufgelöste Werte: meist berechnete Werte, bei einigen layoutabhängigen Eigenschaften jedoch verwendete Werte. Die ursprüngliche Schreibweise im Stylesheet muss dabei nicht erhalten bleiben. Eigenschaftswerte werden als Zeichenfolgen ausgelesen. Anders funktioniert Element.computedStyleMap(): Es stellt berechnete Werte als typisierte Objekte statt als aufgelöste Zeichenfolgen bereit.

Das zurückgegebene CSSStyleProperties erbt von CSSStyleDeclaration; ältere Spezifikationen nannten den letzteren Typ. Werte lassen sich beispielsweise mit styles.marginLeft oder styles.getPropertyValue('margin-left') auslesen. Das Objekt ist lebend: Bei einem erneuten Auslesen wird eine Stiländerung berücksichtigt. Für eine Momentaufnahme speicherst du die ausgelesene Zeichenfolge. Das Ergebnis ist schreibgeschützt; ändere Stile über element.style, das Inline-Deklarationen und nicht das Ergebnis der Stylesheets darstellt.

Ein ungültiges element-Argument führt zu TypeError. Nach dem CSSOM-Algorithmus versucht die Methode nur dann, eine als pseudoElt übergebene Zeichenfolge als Pseudoelement-Selektor zu parsen, wenn sie mit : beginnt. Schlägt das Parsen fehl oder gibt der Selektor ::part() oder ::slotted() an, sieht der Algorithmus die Rückgabe eines Stilobjekts mit leerer Deklarationsliste vor. Eine Zeichenfolge ohne führenden Doppelpunkt, etwa "before", wird nach diesem Algorithmus ignoriert: Die Methode liest die Stile des Elements selbst aus. Die MDN-Referenz zur Methode nennt dagegen TypeError für ungültige Pseudoelement-Selektoren sowie für ::part() und ::slotted(). Aus Datenschutzgründen können Werte zu :visited absichtlich ungenau sein — verwende diese Methode nicht, um den Browserverlauf zu erkennen.

Beispiele

(() => {
  const frame = document.createElement('iframe');
  document.body.append(frame);
  try {
    const doc = frame.contentDocument;
    const box = doc.createElement('div');
    box.style.cssText = 'margin-left: 12px;';
    doc.body.append(box);

    const styles = frame.contentWindow.getComputedStyle(box);
    console.log(styles.getPropertyValue('margin-left'));
    box.style.marginLeft = '24px';
    console.log(styles.marginLeft);
  } finally {
    frame.remove();
  }
})();

Ergebnis

12px
24px

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