CKTIS / JavaScript
CSS.supports() — wykrywanie obsługi funkcji CSS
CSS.supports() sprawdza, czy przeglądarka deklaruje obsługę konkretnej pary właściwość–wartość lub warunku zapytania o funkcje CSS. Zwraca boolean i pomaga dobierać rozwiązania zastępcze bez rozpoznawania przeglądarki po nazwie.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
CSS.supports(propertyName, value)
CSS.supports(supportCondition)CSS.supports() to operacja przestrzeni nazw CSS w Web IDL. Wywołuje się ją bezpośrednio na CSS, bez tworzenia instancji. Jest przeglądarkowym Web API, a nie funkcją zdefiniowaną przez ECMAScript; samo używanie Node 24 nie dowodzi jej dostępności. Przed wywołaniem można sprawdzić istnienie CSS i metody, jak w przykładzie.
Wariant CSS.supports(propertyName, value) przyjmuje dwa ciągi znaków: nazwę właściwości CSS, np. "background-color" zamiast "backgroundColor", oraz badaną wartość. Wynikiem jest true albo false. Sprawdzaj konkretną wartość, ponieważ obsługa właściwości nie oznacza obsługi wszystkich jej wartości.
Wariant CSS.supports(supportCondition) przyjmuje warunek podobny do warunku @supports, bez samego @supports i bloku reguł. Przykład to "(color: red)"; warunki można łączyć operatorami and, or i not. CSS.supports() jedynie zwraca wynik — nie stosuje stylów. Gdy warunkowe stylowanie nie wymaga JavaScript, można użyć bezpośrednio @supports w CSS.
Wynik dodatni oznacza deklarowaną obsługę sprawdzanej składni, nie gwarancję poprawnego wyglądu ani braku błędów lub częściowej implementacji. Zachowaj bazowe style i dodawaj ulepszenia warunkowo. Dostępność samej metody nie gwarantuje obsługi każdej testowanej funkcji.
Przykłady
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"));
}Wynik
true true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.