Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Window.CSS.supports — wykrywanie obsługi funkcji CSS

Sprawdź w JavaScripcie, czy przeglądarka obsługuje konkretną parę właściwość–wartość lub spełnia warunek obsługi CSS, zanim wybierzesz wariant rozszerzony.

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

Składnia

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

Window.CSS.supports oznacza metodę przestrzeni nazw CSS udostępnianej w oknie przeglądarki. W kodzie strony wywołaj window.CSS.supports() albo CSS.supports(), jeśli lokalna deklaracja nie przesłania globalnej nazwy CSS. To API platformy WWW, a nie część ECMAScript 2024 ani statyczna metoda konstruktora Window.

W wersji dwuargumentowej przekaż nazwę właściwości CSS i jej wartość jako osobne napisy, np. CSS.supports("font-size", "1rem"). Użyj nazwy z CSS (font-size, nie fontSize). W wersji jednoargumentowej przekaż sam warunek, bez @supports, np. "(font-size: 1rem)" lub "selector(:has(a))". Warunki można łączyć słowami kluczowymi CSS and, or i not; wewnątrz napisu nie używaj operatorów JavaScriptu &&, || ani !.

Wynik true oznacza, że test obsługi w danej przeglądarce wypadł pozytywnie. Nieobsługiwana para lub niepoprawnie zapisany warunek dają false. Metoda nie nakłada stylów ani nie sprawdza, czy selektor pasuje do elementu. Nawet true nie gwarantuje renderowania bez błędów.

Nie zakładaj dostępności API poza stroną przeglądarki, np. w workerze czy na serwerze. Przed wywołaniem możesz sprawdzić typeof globalThis.CSS?.supports === "function". Brak metody to co innego niż wynik false, lecz w obu przypadkach możesz zachować wariant bazowy. Jeśli warunek ma sterować wyłącznie stylami, użyj reguły @supports bezpośrednio w CSS.

Przykłady

<!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>

Wynik

true
false
true

W konsoli strony przeglądarki obsługującej tę metodę oczekuj kolejno `true`, `false` i `true`. Ostatni warunek sprawdza, czy obie deklaracje są obsługiwane, a nie czy oba kolory zostaną zastosowane jednocześnie.

Powiązane lekcje

  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4

Źródła