WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

CSS.supports() — CSS-Funktionsunterstützung erkennen

CSS.supports() prüft, ob der Browser die Unterstützung für ein bestimmtes Eigenschaft-Wert-Paar oder eine CSS-Abfragebedingung meldet. Die Methode gibt einen booleschen Wert zurück und hilft bei der Auswahl von Fallbacks, ohne den Browser anhand seines Namens zu erkennen.

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

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

CSS.supports() ist eine Operation des Web-IDL-Namensraums CSS. Sie wird direkt auf CSS aufgerufen, ohne eine Instanz zu erstellen. Sie ist eine Browser-Web-API und keine von ECMAScript definierte Funktion; die Verwendung von Node 24 allein belegt nicht, dass sie verfügbar ist. Wie im Beispiel können Sie vor dem Aufruf prüfen, ob CSS und die Methode vorhanden sind.

Die Form CSS.supports(propertyName, value) erwartet zwei Zeichenfolgen: einen CSS-Eigenschaftsnamen, etwa "background-color" statt "backgroundColor", und den zu prüfenden Wert. Sie gibt true oder false zurück. Prüfen Sie den konkreten Wert, denn die Unterstützung einer Eigenschaft bedeutet nicht, dass alle ihre Werte unterstützt werden.

Die Form CSS.supports(supportCondition) erwartet eine Bedingung ähnlich einer @supports-Bedingung, jedoch ohne @supports selbst und ohne Regelblock. Ein Beispiel ist "(color: red)"; Bedingungen lassen sich mit and, or und not kombinieren. CSS.supports() gibt lediglich ein Ergebnis zurück und wendet keine Styles an. Wenn bedingtes Styling kein JavaScript benötigt, können Sie @supports direkt in CSS verwenden.

Ein positives Ergebnis bedeutet, dass die Unterstützung für die geprüfte Syntax gemeldet wird. Es garantiert weder die korrekte Darstellung noch Fehlerfreiheit oder eine vollständige Implementierung. Behalten Sie Basisstile bei und ergänzen Sie sie bedingt. Dass die Methode selbst verfügbar ist, garantiert nicht die Unterstützung jeder geprüften Funktion.

Beispiele

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"));
}

Ergebnis

true
true
false

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