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

CKTIS / JavaScript

Window.getComputedStyle — leer estilos resueltos

Window.getComputedStyle lee los valores CSS resueltos de un elemento después de aplicar las hojas de estilo. Devuelve un objeto vivo de solo lectura, no una copia de las declaraciones en línea.

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

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

Window.getComputedStyle, llamada como window.getComputedStyle(element, pseudoElt), es una API del navegador CSSOM, no una función de ECMAScript. El método cuenta con amplia compatibilidad; disponer de Node 24 no confirma que esté disponible. element debe ser un objeto Element. El argumento opcional pseudoElt, como "::before", selecciona un pseudoelemento; si se omite o es null, se selecciona el propio elemento.

El resultado contiene valores resueltos: normalmente valores calculados, aunque para algunas propiedades que dependen del diseño contiene valores usados. No tiene por qué conservar la notación original de la hoja de estilo. La lectura de propiedades devuelve cadenas. Element.computedStyleMap() funciona de otra manera: expone valores calculados como objetos tipados, en lugar de cadenas resueltas.

El CSSStyleProperties devuelto hereda de CSSStyleDeclaration; las especificaciones anteriores indicaban este último tipo. Lee valores, por ejemplo, con styles.marginLeft o styles.getPropertyValue('margin-left'). El objeto es vivo: una lectura posterior refleja los cambios de estilo. Para guardar una instantánea, conserva la cadena que has leído. El resultado es de solo lectura; cambia los estilos mediante element.style, que representa las declaraciones en línea, no el resultado de las hojas de estilo.

Un argumento element no válido provoca un TypeError. Según el algoritmo de CSSOM, el método solo intenta interpretar una cadena pasada como pseudoElt como selector de pseudoelemento si empieza por :. Si falla el análisis o el selector indica ::part() o ::slotted(), el algoritmo devuelve un objeto de estilo con una lista de declaraciones vacía. Según ese algoritmo, una cadena que no empieza por dos puntos, como "before", se ignora: el método lee los estilos del propio elemento. La documentación del método en MDN, en cambio, indica que se lanza un TypeError con selectores de pseudoelemento no válidos y con ::part() y ::slotted(). Por motivos de privacidad, los valores relacionados con :visited pueden ser deliberadamente inexactos: no uses este método para detectar el historial de navegación.

Ejemplos

(() => {
  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();
  }
})();

Resultado

12px
24px

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