CKTIS / JavaScript
Window.getComputedStyle — lire les styles résolus
Window.getComputedStyle lit les valeurs CSS résolues d’un élément après l’application des feuilles de style. La méthode renvoie un objet vivant en lecture seule, et non une copie des déclarations en ligne.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)Window.getComputedStyle, appelée sous la forme window.getComputedStyle(element, pseudoElt), est une API de navigateur CSSOM, et non une fonction ECMAScript. Cette méthode est largement prise en charge ; la présence de Node 24 ne garantit pas qu’elle soit disponible. element doit être un objet Element. L’argument facultatif pseudoElt, tel que "::before", sélectionne un pseudo-élément ; s’il est omis ou vaut null, c’est l’élément lui-même qui est visé.
Le résultat contient des valeurs résolues : généralement des valeurs calculées, mais des valeurs utilisées pour certaines propriétés dépendant de la mise en page. Il ne conserve pas nécessairement la notation d’origine de la feuille de style. La lecture des propriétés renvoie des chaînes. Element.computedStyleMap() est différent : il expose les valeurs calculées sous forme d’objets typés, et non de chaînes résolues.
L’objet CSSStyleProperties renvoyé hérite de CSSStyleDeclaration ; les anciennes spécifications nommaient ce dernier type. Lisez les valeurs, par exemple avec styles.marginLeft ou styles.getPropertyValue('margin-left'). L’objet est vivant : une lecture ultérieure reflète une modification de style. Pour conserver un instantané, enregistrez la chaîne lue. Le résultat est en lecture seule ; modifiez les styles avec element.style, qui représente les déclarations en ligne et non le résultat des feuilles de style.
Un argument element invalide provoque une exception TypeError. Selon l’algorithme du CSSOM, la méthode ne tente d’analyser une chaîne passée dans pseudoElt comme un sélecteur de pseudo-élément que si elle commence par :. Si l’analyse échoue ou si le sélecteur désigne ::part() ou ::slotted(), l’algorithme prévoit le renvoi d’un objet de style dont la liste de déclarations est vide. Selon cet algorithme, une chaîne qui ne commence pas par deux-points, comme "before", est ignorée : la méthode lit les styles de l’élément lui-même. La documentation de la méthode sur MDN indique au contraire qu’une exception TypeError est levée pour les sélecteurs de pseudo-élément invalides ainsi que pour ::part() et ::slotted(). Pour des raisons de confidentialité, les valeurs concernant :visited peuvent être volontairement inexactes — n’utilisez pas cette méthode pour détecter l’historique de navigation.
Exemples
(() => {
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();
}
})();Résultat
12px 24px
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.