CKTIS / JavaScript
Window.CSS.supports — Unterstützung von CSS-Funktionen prüfen
Prüfe in JavaScript, ob der Browser ein bestimmtes CSS-Eigenschaft-Wert-Paar unterstützt oder eine CSS-Unterstützungsbedingung erfüllt, bevor du erweitertes Verhalten aktivierst.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
window.CSS.supports(propertyName, value)
window.CSS.supports(supportCondition)Window.CSS.supports bezeichnet die Methode supports des Namensraums CSS im Browserfenster. Rufe im Seitencode window.CSS.supports() auf oder verwende CSS.supports(), wenn keine lokale Deklaration den globalen Namen CSS verdeckt. Es handelt sich um eine Web-API, nicht um einen Teil von ECMAScript 2024 oder eine statische Methode des Konstruktors Window.
Übergib bei zwei Argumenten den CSS-Eigenschaftsnamen und den Wert als getrennte Zeichenfolgen, etwa CSS.supports("font-size", "1rem"). Verwende die CSS-Schreibweise (font-size, nicht fontSize). Übergib bei einem Argument nur die Bedingung ohne @supports, etwa "(font-size: 1rem)" oder "selector(:has(a))". Verknüpfe Bedingungen innerhalb der Zeichenfolge mit den CSS-Schlüsselwörtern and, or und not, nicht mit den JavaScript-Operatoren &&, || und !.
true bedeutet, dass die Prüfung im jeweiligen Browser erfolgreich war. Ein nicht unterstütztes Paar oder eine fehlerhaft formulierte Bedingung ergibt false. Die Methode wendet keine Stile an und prüft nicht, ob ein Selektor auf ein Element zutrifft. Auch true garantiert keine fehlerfreie Darstellung.
Setze die API außerhalb von Browserseiten, etwa in Workern oder auf Servern, nicht voraus. Prüfe vor dem Aufruf bei Bedarf typeof globalThis.CSS?.supports === "function". Eine fehlende Methode und ein Ergebnis von false sind nicht dasselbe, können aber zur gleichen Ausweichlösung führen. Steuert die Bedingung nur Stile, verwende die At-Regel @supports direkt in CSS.
Beispiele
<!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>Ergebnis
true false true
In der Konsole einer Browserseite mit dieser Methode ist die erwartete Reihenfolge `true`, `false`, `true`. Die letzte Bedingung prüft, ob beide Deklarationen unterstützt werden, nicht ob beide Farben gleichzeitig angewendet werden.
Zugehörige Lektionen
- JavaScript · Lektion 37 · Fortgeschritten · Version: 4