Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Window.CSS.supports — détecter la prise en charge de CSS

Vérifiez en JavaScript si le navigateur prend en charge une paire propriété-valeur CSS précise ou satisfait une condition de prise en charge avant d’activer un comportement amélioré.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

window.CSS.supports(propertyName, value)
window.CSS.supports(supportCondition)

Window.CSS.supports désigne la méthode supports de l’espace de noms CSS de la fenêtre du navigateur. Dans le code d’une page, appelez window.CSS.supports() ou utilisez CSS.supports() si rien ne masque le nom global CSS. Cette méthode appartient à une API Web : elle ne fait pas partie d’ECMAScript 2024 et n’est pas une méthode statique du constructeur Window.

Avec deux arguments, passez le nom de la propriété CSS et sa valeur dans deux chaînes distinctes, par exemple CSS.supports("font-size", "1rem"). Employez le nom CSS (font-size, pas fontSize). Avec un seul argument, passez la condition seule, sans @supports, par exemple "(font-size: 1rem)" ou "selector(:has(a))". Dans la chaîne, combinez les conditions avec les mots-clés CSS and, or et not, et non avec les opérateurs JavaScript &&, || et !.

true indique que le test de prise en charge a réussi dans ce navigateur. Une paire non prise en charge ou une condition mal formée renvoie false. La méthode n’applique aucun style et ne vérifie pas si un sélecteur correspond à un élément. Même true ne garantit pas un rendu sans défaut.

Ne supposez pas que cette API est disponible hors d’une page de navigateur, par exemple dans un worker ou sur un serveur. Avant de l’appeler, vous pouvez vérifier typeof globalThis.CSS?.supports === "function". Une méthode absente et un résultat false sont deux cas distincts, mais peuvent mener à la même solution de repli. Si la condition ne contrôle que des styles, utilisez directement la règle @supports en CSS.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>CSS.supports example</title>
<script>
  console.log(window.CSS.supports("color", "red"));
  console.log(window.CSS.supports("color", "123px"));
  console.log(window.CSS.supports("(color: red) and (color: blue)"));
</script>

Résultat

true
false
true

Dans la console d’une page de navigateur qui expose la méthode, attendez-vous à `true`, `false`, puis `true`. La dernière condition vérifie que les deux déclarations sont prises en charge, pas que les deux couleurs sont appliquées en même temps.

Leçons associées

  • JavaScript · Leçon 37 · Avancé · Version : 4

Sources