CKTIS / JavaScript
CSS.supports() — détecter la prise en charge des fonctionnalités CSS
CSS.supports() vérifie si le navigateur indique prendre en charge une paire propriété-valeur précise ou une condition de requête de fonctionnalité CSS. La méthode renvoie un booléen et aide à choisir des solutions de repli sans identifier le navigateur par son nom.
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
CSS.supports(propertyName, value)
CSS.supports(supportCondition)CSS.supports() est une opération de l’espace de noms CSS en Web IDL. Elle s’appelle directement sur CSS, sans créer d’instance. Il s’agit d’une API Web du navigateur, et non d’une fonction définie par ECMAScript ; utiliser Node 24 ne suffit pas à établir sa disponibilité. Comme dans l’exemple, vous pouvez vérifier que CSS et la méthode existent avant de l’appeler.
La forme CSS.supports(propertyName, value) accepte deux chaînes : un nom de propriété CSS, par exemple "background-color" plutôt que "backgroundColor", et la valeur à tester. Elle renvoie true ou false. Testez la valeur précise, car la prise en charge d’une propriété n’implique pas celle de toutes ses valeurs.
La forme CSS.supports(supportCondition) accepte une condition semblable à une condition @supports, sans @supports lui-même ni bloc de règles. "(color: red)" en est un exemple ; les conditions peuvent être combinées avec and, or et not. CSS.supports() renvoie uniquement un résultat : elle n’applique pas de styles. Si le style conditionnel ne nécessite pas JavaScript, vous pouvez utiliser directement @supports en CSS.
Un résultat positif signifie que la prise en charge de la syntaxe testée est signalée ; il ne garantit ni un rendu correct, ni l’absence de bogues ou d’implémentations partielles. Conservez les styles de base et ajoutez les améliorations de façon conditionnelle. La disponibilité de la méthode ne garantit pas la prise en charge de chaque fonctionnalité testée.
Exemples
if (typeof CSS === "undefined" || typeof CSS.supports !== "function") {
console.log("CSS.supports unavailable");
} else {
console.log(CSS.supports("color", "red"));
console.log(CSS.supports("(color: red)"));
console.log(CSS.supports("color", "not-a-color"));
}Résultat
true true false
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.